Agent

🚀 1MCP 代理サーバー

1MCP 代理サーバー（略称「1MCP」）は、複数の MCP サーバーを集中管理するツールです。これにより、AI アシスタントは単一のインターフェースを通じて、異なる機能を持つサーバーを呼び出すことができ、各サーバーを直接管理する必要がなくなります。

🚀 クイックスタート

グローバル設定ファイルの場所

1MCP のグローバル設定ファイルは以下の場所にあります。

• macOS/Linux：~/.config/1mcp/mcp.json
• Windows：%APPDATA%/1mcp/mcp.json

設定ファイルの形式例

{
  "mcpServers": {
    "mcp-server-fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    },
    "server-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "disabled": false
    }
  }
}

起動コマンド

# 標準モード
pnpm dev

# 標準入出力モード
pnpm dev-stdio

✨ 主な機能

• 統一インターフェース：AI アシスタントは SSE または HTTP プロトコルを通じて 1MCP と通信します。
• 複数サーバー管理：複数の MCP サーバーインスタンスを同時に実行できます。
• タグ制御：タグを使用して、サーバーを選択的に有効または無効にできます。
• リクエストルーティング：必要に応じて、リクエストを適切なサーバーに配信します。

📚 ドキュメント

システムアーキテクチャ図

graph TB
    subgraph "AI 助手"
        A1[Claude Desktop]
        A2[Cursor]
        A3[Cherry Studio]
        A4[Roo Code]
    end

    subgraph "1MCP 代理服务器"
        MCP[1MCP Agent]
    end

    subgraph "MCP 服务器"
        S1[Server 1]
        S2[Server 2]
        S3[Server 3]
    end

    A1 -->|sse| MCP
    A2 -->|sse| MCP
    A3 -->|sse| MCP
    A4 -->|sse| MCP

    MCP --> |sse| S1
    MCP --> |stdio| S2
    MCP --> |stdio| S3

リクエストフローチャート

sequenceDiagram
    participant 客户端 as AI 助手
    participant 代理服务器 as 1MCP Server
    participant MCP 服务器 as MCP Servers

    客户端->>代理服务器: 发送 MCP 请求
    activate 代理服务器

    代理服务器->>代理服务器: 验证请求
    代理服务器->>代理服务器: 加载配置
    代理服务器->>MCP 服务器: 转发请求
    activate MCP 服务器

    MCP 服务器-->>代理服务器: 响应
    deactivate MCP 服务器

    代理服务器-->>客户端: 转发响应
    deactivate 代理服务器

タグの使用方法

タグ定義の例

{
  "mcpServers": {
    "web-server": {
      "command": "uvx",
      "args": ["mcp-server-web"],
      "disabled": false,
      "tags": ["web", "http"]
    },
    "file-server": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-file"],
      "disabled": false,
      "tags": ["file", "storage"]
    }
  }
}

タグフィルタリングルール

• タグを含む：--tag=web または --tag=file
• タグを除外する：--exclude-tag=debug
• 組み合わせて使用する：--tag=web --exclude-tag=test

開発情報

プロジェクト構造

1mcp/
├── src/              # ソースコードディレクトリ
│   ├── main.ts       # メインプログラムのエントリーポイント
│   └── server.ts     # 代理サーバーの実装
├── package.json      # 依存関係管理ファイル
└── tsconfig.json     # TypeScript の設定ファイル

開発コマンド

# 依存関係のインストール
pnpm install

# 開発環境の起動
pnpm dev

# パッケージのビルド
pnpm build

ドキュメントの拡張

詳細情報については、公式ドキュメントを参照してください。