MCP Agent Server

🚀 MCP 代理サーバー使用ガイド

MCP Agent Server は、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 代理サーバーを簡単に設定し、効率的に使用して開発効率を向上させることができます。