MCP Agent Server

🚀 MCP 代理服务器使用指南

MCP 代理服务器是一款基于 mcp - ai - agent 框架构建的强大工具，它支持多种 AI 模型和工具的集成。本指南将详细指导你如何配置、连接并使用 MCP 代理服务器，帮助你提升开发效率。

🚀 快速开始

安装与运行

克隆仓库

从 GitHub 克隆 MCP Agent Server 仓库：

git clone https://github.com/yourusername/mcp-agent-server.git
cd mcp-agent-server

安装依赖

安装项目所需的依赖项：

npm install

启动服务器

运行以下命令启动 MCP 代理服务器：

node src/index.js

📦 安装指南

配置 MCP Agent Server

编辑 config.json 文件，根据需求配置代理服务器：

{
  "agents": [
    {
      "name": "AI 分析器",
      "description": "集成多种 AI 模型的分析工具",
      "tools": [
        { "type": "ai", "model": "claude-3" },
        { "type": "tool", "name": "数据统计" }
      ]
    }
  ],
  "serverSettings": {
    "port": 3001,
    "host": "localhost"
  }
}

配置 MCP 客户端

在 VS Code 中配置

编辑 settings.json 文件，添加 MCP 代理服务器：

{
  "mcp.servers": [
    {
      "name": "MCP Agent Server",
      "command": "node",
      "args": ["${fileDirname}/../mcp-agent-server/dist/index.js"]
    }
  ]
}

在其他 MCP 客户端中配置

按照具体客户端的文档，添加以下配置：

• 命令：node
• 参数：["/full/path/to/mcp-agent-server/dist/index.js"]

💻 使用示例

基础用法

启动 VS Code 的 MCP 支持功能，选择你配置好的代理服务器。输入 / 查看可用工具，并根据提示使用相关功能。

高级用法

创建自定义工具

在 config.json 中添加自定义工具：

{
  "agents": [
    {
      "name": "计算器",
      "description": "基本计算器工具",
      "tools": [
        {
          "type": "custom",
          "name": "乘法运算",
          "parameters": {
            "number1": "数字1",
            "number2": "数字2"
          },
          "execute": "multiplyNumbers"
        }
      ]
    }
  ]
}

使用 MCP 服务器

• 序列思维服务器：分解复杂问题。
• 记忆服务器：存储和检索信息。
• Brave 搜索服务器：执行网络搜索。

🔧 技术细节

故障排除

• 确保 MCP 服务器配置正确无误。
• 对于 npx 命令，确保使用全路径。
• 验证所有必要的 API 密钥是否在环境中可用。
• 检查 MCP 客户端的配置是否正确。

开发

1. 修改 TypeScript 文件。
2. 使用 npm run build 重建项目。
3. 重启 MCP 客户端加载更新。

CLI 使用

测试代理

直接从命令行测试特定代理：

npm run test-agent -- --name="代理名称" --prompt="测试提示" --context="可选上下文"

例如，测试 Bravery 搜索代理：

npm run test-agent -- --name="Brave 搜索" --prompt="法国的首都是哪里？" --context="需要地理信息"

列出可用代理

运行以下命令查看所有配置的代理：

npm run list-agents

📚 详细文档

MCP Agent Server 提供了强大的 AI 工具集成和高度可定制的功能，适用于多种开发场景。通过本文的指导，你可以轻松配置并高效使用 MCP 代理服务器，提升开发效率。