MCP Remote Server

🚀 mcp-远程服务器

このサーバーは、可配置なモデルコンテキストプロトコル（MCP）サーバーで、その機能はリモート構成を通じて動的にロードされます。モデルコンテキストプロトコルを利用してローカルサーバーを作成し、ローカルのMCPクライアントと通信できるようになります。

🚀 クイックスタート

mcp-remote-serverは、MCPクライアントとリモートAPIの間の橋渡しを行います。MCP_CONTROL_PLANE_URLで指定されたリモートでホストされている構成を解析し、この構成にはツール、リソース、およびプロンプトのリストが含まれており、それぞれがリモートAPIエンドポイントを指しています。

✨ 主な機能

• 動的構成：サーバーの機能は、リモートのJSON構成によって定義されます。
• 自動更新：構成は60秒ごとに自動的に更新されます。
• すべてのMCPプリミティブをサポート：
  • ツール：リモートAPI呼び出しを通じて操作を実行します。
  • リソース：リモートデータを読み取り可能なリソースとして公開します。
  • プロンプト：再利用可能なプロンプトテンプレートを定義します。

📦 インストール

bun install

💻 使用例

基本的な使用法

1. コントロールプレーンURLを設定します。

export MCP_CONTROL_PLANE_URL="https://your-config-endpoint"

2. サーバーを起動します。

bun run index.ts

構成フォーマット

{
  "tools": [{
    "name": "tool-name",
    "description": "工具描述",
    "inputSchema": {
      "type": "object",
      "properties": {
        // JSON Schema用于工具输入
      }
    },
    "handler": "https://api.example.com/tool-endpoint"
  }],
  "resources": [{
    "uri": "resource://identifier",
    "name": "资源名称",
    "description": "资源描述",
    "mimeType": "application/json",
    "handler": "https://api.example.com/resource-endpoint"
  }],
  "prompts": [{
    "name": "prompt-name",
    "description": "提示描述",
    "arguments": [{
      "name": "arg-name",
      "description": "参数描述",
      "required": true
    }],
    "handler": "https://api.example.com/prompt-endpoint"
  }]
}

ハンドラーAPIの要件

リモートハンドラーは、適切な形式の応答を返す必要があります。

• ツールハンドラー：JSONを返し、これは文字列化され、MCPツール応答にラップされます。
• リソースハンドラー：指定されたmimeTypeに一致するコンテンツを返します。
• プロンプトハンドラー：文字列（自動的にメッセージにラップされます）またはMCP形式のメッセージ配列を返します。

🔧 技術詳細

制限事項

• HTTP/HTTPSハンドラーエンドポイントのみをサポートします。
• 構成はHTTP GETリクエストでアクセス可能である必要があります。
• ハンドラーの応答はJSON互換である必要があります。
• ローカルでのみ実行されます（標準的なMCPの制限）。

このプロジェクトはbun initを使用して作成され、bun v1.1.32のバージョンです。Bunは高速なワンストップJavaScriptランタイムです。私はBunを選んだ理由は、その速度が速いことと、何か新しいものを試してみたかったからです。

このプロジェクトはまた、Biomeを使用して型チェックとコードフォーマットを行っています。私がBiomeを選んだ理由も、Bunを選んだ理由と同じです。JSにgofmtのようなツールが欲しかったからです。これは良いスタートです。