Agentico MCP Server 使用说明

项目简介

Agentico MCP Server 是一个简化 Model Context Protocol (MCP) 服务器实现的工具。它通过提供一个外观模式，降低了构建 MCP 服务器的复杂性，特别是简化了工具的集成和管理。该项目旨在帮助开发者更快速、便捷地搭建 MCP 服务器，为大型语言模型 (LLM) 应用提供上下文信息和功能扩展。

主要功能点

简化 MCP 服务器创建: 通过外观模式封装了 MCP 服务器的复杂性，使得开发者可以更专注于工具的开发和集成。
工具注册与管理: 提供 'MCPServer' 类用于注册和管理各种工具 (Tools)，每个工具可以有自定义的逻辑和 schema。
标准 MCP 协议支持: 完全兼容 Model Context Protocol，可以与任何支持 MCP 协议的客户端（如 Claude Desktop）进行通信。
可扩展性: 易于扩展和添加新的工具，满足不同的 LLM 应用场景需求。
OpenTelemetry 集成: 可选集成 OpenTelemetry 用于监控和追踪服务器运行状态（通过 'exporterUrl' 配置）。

安装步骤

创建项目目录并初始化:

mkdir my-mcp-server && cd my-mcp-server
yarn init -y

添加依赖:

yarn add @agentico/mcp-server @modelcontextprotocol/sdk zod zod-to-json-schema
yarn add -D @types/node typescript

配置 'tsconfig.json' 和 'package.json': 根据需要创建 'tsconfig.json' 文件，并更新 'package.json' 文件以包含构建和启动脚本 (具体配置可参考仓库 README 或官方文档)。
创建工具 (Tools): 在 'src/tools' 目录下创建工具文件 (例如 'EchoTool.ts')，并继承 'Tool' 类，实现自定义工具的逻辑。参考示例 'EchoTool.ts' 代码。
创建 'index.ts' 并注册工具: 在 'src/index.ts' 文件中，实例化 'MCPServer' 并注册你创建的工具。参考示例 'index.ts' 代码。
构建项目:
```
yarn build
```

服务器配置 (MCP 客户端配置)

MCP 客户端需要以下 JSON 配置信息来连接到 Agentico MCP Server。请根据你的实际情况进行配置。

{
  "serverName": "My MCP Server",  //  自定义服务器名称，在客户端中显示
  "command": "node",             //  启动服务器的命令，这里使用 Node.js 运行时
  "args": ["build/index.js"]    //  命令参数，指向构建后的服务器入口文件
}

基本使用方法

启动 MCP 服务器:

yarn start
# 或
node build/index.js

服务器成功启动后，将监听 MCP 客户端的连接。

配置 MCP 客户端: 在支持 MCP 协议的客户端 (如 Claude Desktop) 中，配置自定义服务器，并填入上述 服务器配置 (MCP 客户端配置) 中的 JSON 信息。
使用客户端调用工具: 客户端连接成功后，即可发现并调用你在服务器中注册的工具，与 LLM 进行交互，并利用工具提供的功能扩展 LLM 的能力。

关键词