使用说明

项目简介

Agentek MCP Server 是 Agentek 工具包的一个组件，它实现了 Model Context Protocol (MCP) 协议，充当 LLM 客户端和 Agentek 工具之间的桥梁。通过 MCP 协议，Agentek MCP Server 允许 LLM 客户端以标准化的方式调用 Agentek 提供的区块链交互工具，从而扩展 LLM 在 Web3 应用中的能力。

主要功能点

工具注册与执行: Agentek MCP Server 托管并暴露 Agentek 工具包中丰富的区块链交互工具，例如 ERC20 代币操作、ENS 查询、Uniswap V3 交互、交易查询等，允许 LLM 客户端通过标准 MCP 协议调用这些工具。
资源数据访问: 虽然仓库信息侧重于工具，但 MCP 服务器的定义也包含资源管理。Agentek 工具本身提供了链上数据的访问能力，可以被视为 MCP 服务器提供的资源访问能力的体现。
Prompt 模板支持: 虽然仓库信息没有明确提及 Prompt 模板，但 Agentek 工具的设计理念和 AI SDK 的集成表明它支持可定制的 LLM 交互模式，可以通过工具组合和编排来实现 Prompt 模板的功能。
JSON-RPC 通信: Agentek MCP Server 基于 JSON-RPC 协议与客户端通信，符合 MCP 协议的要求。
Stdio 传输协议: 服务器默认使用 Stdio 作为传输协议，方便集成和部署。
能力声明与会话管理: MCP Server 具备基本的服务端能力声明，并通过 '@modelcontextprotocol/sdk/server' 库进行会话管理。

安装步骤

安装 Agentek 工具包: 打开终端，使用 npm 或 yarn 安装 Agentek 工具包。

npm install @agentek/tools

或

yarn add @agentek/tools

安装 Agentek MCP Server: Agentek MCP Server 包含在 '@agentek/tools' 工具包中，无需单独安装。

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接 Agentek MCP Server。请注意，以下配置信息为 JSON 格式，请勿包含任何代码。

{
  "serverName": "agentek-mcp-server",
  "command": "agentek-mcp-server",
  "args": [],
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器名称，可以自定义，例如 "agentek-mcp-server"。
'command': MCP 服务器的启动命令。由于 'packages/mcp/tsup.config.ts' 中配置了 'banner: { js: "#!/usr/bin/env node", }'，并且 'package.json' 中 'packages/mcp' 定义了 'bin: "dist/index.js"'，因此可以直接使用 'agentek-mcp-server' 命令启动服务器 (前提是将 'packages/mcp' 构建后的 'dist' 目录加入到环境变量 'PATH' 中)。
'args': 启动命令的参数。Agentek MCP Server 默认不需要额外的启动参数，因此配置为空数组 '[]'。
'transport': 传输协议。Agentek MCP Server 基于 Stdio 传输协议，因此配置为 '"stdio"'。

注意: 请确保 Node.js 环境已正确安装，并且 '@agentek/tools' 工具包已安装在 MCP 客户端可以访问到的位置。为了能够直接使用 'agentek-mcp-server' 命令，你可能需要将项目根目录下的 'packages/mcp/dist' 目录添加到系统的 'PATH' 环境变量中，或者使用 'node packages/mcp/dist/index.js' 作为 'command'。

基本使用方法

启动 Agentek MCP Server: 在终端中运行以下命令启动 Agentek MCP Server：
```
agentek-mcp-server
```
或 (如果 'agentek-mcp-server' 命令无法直接使用)
```
node packages/mcp/dist/index.js
```
服务器成功启动后，会在终端输出日志信息，指示服务器正在运行并监听 Stdio。
配置 MCP 客户端: 在你的 LLM 应用或 MCP 客户端中，配置上述 服务器配置 JSON 信息，确保客户端能够连接到 Agentek MCP Server。
通过 MCP 客户端调用工具: 使用 MCP 客户端向 Agentek MCP Server 发送 MCP 格式的请求，例如 'ListToolsRequest' 获取可用工具列表，或 'CallToolRequest' 执行特定的 Agentek 工具。

具体的工具调用方法和参数，请参考 Agentek 工具包的文档和工具描述信息。

总结

Agentek MCP Server 提供了一种将 Agentek 工具包集成到 LLM 应用的标准化方式，使得开发者可以利用 Agentek 强大的区块链交互能力，构建更加智能和实用的 Web3 应用。

Agentek MCP Server