MCP 91c

🚀 MCP クライアントプロジェクト

MCP クライアントプロジェクトは、Flask フレームワークを通じてローカルの MCP サーバーを公開し、内部ネットワークのトンネリング機能を実現します。このプロジェクトにより、Coze、Dify、FastGPT などのプラットフォームがローカルリソースと相互作用できるようになります。

🚀 クイックスタート

MCP クライアントプロジェクトを使用することで、Flask フレームワークを介してローカルの MCP サーバーを外部に公開し、Coze、Dify、FastGPT などのプラットフォームがローカルリソースと通信できるようになります。

✨ 主な機能

• Flask フレームワークを使用してローカルの MCP サーバーを公開する。
• 内部ネットワークのトンネリング機能を提供し、外部プラットフォームがローカルリソースと通信できるようにする。

📦 インストール

このセクションでは、原ドキュメントに具体的なインストール手順が記載されていないため、省略します。

💻 使用例

基本的な使用法

示例 1: ツールリストの取得

curl -X POST http://localhost:5000/list_tool \
-H "Content-Type: application/json" \
-d '{"server_name":"weather","secret_key":"your-secret-key"}'

示例 2: ツールの呼び出し

curl -X POST http://localhost:5000/call_tool \
-H "Content-Type: application/json" \
-d '{"server_name":"weather","tool_name":"get_weather","params":{"city":"Beijing"},"secret_key":"your-secret-key"}'

📚 ドキュメント

設定ファイルの説明

mcp_server.json

このファイルは、MCP サーバーの情報を設定するために使用されます。具体的な内容は以下の通りです。

{
    "servers": [
        {
            "name": "server1", // サーバー名（自由に設定可能）
            "type": "http",   // タイプ：http または https
            "path": "/path/to/server1", // サービスの起動パス
            "port": 8080,     // サービスのポート
            "command": "python server1.py" // 起動コマンド
        },
        {
            "name": "server2",
            "type": "http",
            "path": "/path/to/server2",
            "port": 8081,
            "command": "python server2.py"
        }
    ]
}

⚠️ 重要提示

• パスと起動コマンドが正しいことを確認してください。
• サーバータイプが HTTPS の場合は、type フィールドで指定してください。

セキュリティに関する注意事項

環境変数のセキュリティ

.env ファイルには API キーなどの機密情報が含まれています。以下のことに注意して保管してください。

⚠️ 重要提示

• .env ファイルをバージョン管理システムにコミットしないでください。
• ファイルを公開された場所に置かないでください。

デバッグモードの使用に関する提案

デバッグモードは開発環境でのみ使用し、本番環境では無効にしてください。

app.run(debug=True, ssl_context='adhoc')

証明書問題の解決策

自己署名証明書の問題

クラウドプラットフォームにデプロイする際、自己署名証明書により静的リソースの取得が失敗する場合があります。

解決策：

1. ローカル開発環境： 自己署名証明書とデバッグモードを使用します。
2. 本番環境： 信頼できる CA によって発行された実際の SSL 証明書をデプロイします。クラウドプラットフォームのドキュメントを参照して設定を完了してください。

API インターフェースの説明

1. ツールリストの取得

• リクエスト方法： POST
• URL: /list_tool
• リクエストボディの例：

  {
      "server_name": "weather",
      "secret_key": "your-secret-key"
  }
  

• レスポンスの例：

  {
      "tools": ["get_weather", "forecast"]
  }
  

2. ツールの呼び出し

• リクエスト方法： POST
• URL: /call_tool
• リクエストボディの例：

  {
      "server_name": "weather",
      "tool_name": "get_weather",
      "params": {"city": "Beijing"},
      "secret_key": "your-secret-key"
  }
  

3. サーバーリストの取得

• リクエスト方法： GET
• URL: /list_server
• レスポンスの例：

  {
      "servers": ["server1", "server2"]
  }
  

4. ファイルリストの取得

• リクエスト方法： GET
• URL: /list_files
• レスポンスの例：

  {
      "files": ["file1.txt", "file2.csv"]
  }
  

5. ファイルのダウンロード

• リクエスト方法： GET
• URL: /get_download_link?filename=file1.txt&secret_key=your-secret-key
• レスポンスの例：

  {
      "download_url": "http://example.com/file1.txt"
  }
  

🔧 技術詳細

このセクションでは、原ドキュメントに十分な技術的詳細が記載されていないため、省略します。

📄 ライセンス

このセクションでは、原ドキュメントにライセンス情報が記載されていないため、省略します。