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 代理服務器，提升開發效率。