MCP 91c

🚀 MCP 客戶端項目文檔

MCP 客戶端項目藉助 Flask 框架將本地的 MCP 服務器暴露出來，實現內網穿透功能。這一項目讓 Coze、Dify 和 FastGPT 等平臺能夠與本地資源進行交互，為資源的有效利用提供了便利。

🚀 快速開始

本項目主要通過配置文件和 API 接口來實現功能，下面將詳細介紹相關內容。

✨ 主要特性

• 利用 Flask 框架將本地 MCP 服務器暴露，實現內網穿透。
• 支持 Coze、Dify 和 FastGPT 等平臺與本地資源交互。

📦 安裝指南

文檔未提及安裝步驟，暫不提供。

📚 詳細文檔

配置文件說明

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 證書。參考雲平臺文檔完成配置。

💻 使用示例

示例 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"}'

📄 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"
}

🔧 技術細節

文檔未提及技術實現細節，暫不提供。

📄 許可證

文檔未提及許可證信息，暫不提供。

注意事項

⚠️ 重要提示

• 確保所有 API 請求包含正確的 secret_key。
• 根據實際需求調整服務器配置和權限設置。

通過以上步驟，您可以成功配置並使用 MCP 客戶端項目。