MCP Tool Kit

🚀 MCP 工具包

MCP 工具包代表了人機合作的新範式，它建立了人類與人工智能的認知夥伴關係。通過該工具包，人類的戰略思維與 AI 的操作能力相輔相成，實現更高效的協作。

🚀 快速開始

克隆倉庫

使用以下命令克隆 MCP 工具包倉庫：

git clone git@github.com:your-username/mcp-tool-kit.git
cd mcp-tool-kit

安裝依賴項

運行以下命令安裝項目所需的 Python 依賴項：

pip install -r requirements.txt

配置環境變量（Windows）

要將 Git 添加到系統路徑，請按照以下步驟操作：

1. 打開“編輯系統環境變量”應用程序，可以通過控制面板或搜索“編輯系統環境變量”來找到。
2. 在“系統變量”部分，找到“Path”變量並點擊“編輯...”。
3. 添加 Git 安裝目錄的路徑（例如：C:\Program Files\Git\bin 和 C:\Program Files\Git\cmd）。
4. 保存更改後，重新打開命令提示符窗口以應用新的 PATH 設置。

啟動服務

運行以下命令啟動 MCP 統一服務器：

python mcp_unified_server.py

📦 安裝指南

配置指南

將所有 API 密鑰和配置參數添加到config.json文件中：

{
  "news_api_key": "your-news-api-key",
  "world_bank_api_key": "your-world-bank-api-key",
  "git_path": "C:\\Program Files\\Git\\bin"
}

💻 使用示例

工具擴展

添加新工具模塊

1. 在tools目錄下創建一個新的 Python 文件（例如：my_tool.py）。
2. 按照現有模塊的模式實現功能：
   • 創建服務類
   • 定義工具函數
   • 實現註冊函數
3. 更新mcp_unified_server.py以導入並註冊新的模塊。

擴展現有工具模塊

1. 向服務類中添加新方法。
2. 在工具函數中實現新功能。
3. 更新註冊函數以包含新工具。

Docker 開發環境

使用 Docker 進行開發可以保證環境一致性：

# 構建開發鏡像
docker build -t mcp-tool-kit:dev .

# 以開發模式運行容器
docker run -p 8000:8000 \
    -v $(pwd):/app \
    -v ~/documents:/app/documents \
    mcp-tool-kit:dev

此命令將本地代碼和文檔目錄掛載到容器中，因此代碼更改會立即生效（針對大多數文件）。

📚 詳細文檔

哲學視角：人機認知夥伴關係

MCP 工具包代表了人類與人工智能關係的一個範式轉變。它不再將 AI 視為簡單的任務自動化工具，而是建立了一種認知合作伙伴關係，其中人類的戰略思維能力和 AI 的操作能力相輔相成。

這種代理架構體現了變革性的願景：AI 系統能夠獨立解釋上下文、在限定參數內進行決策並執行復雜操作序列——同時保持人類的監督和戰略指導。這不僅是一項技術進步，更是人機協作的新模式。

在這種不斷發展的認知格局中，最成功的實現將是那些能夠審慎平衡技術潛力與人類能力的系統，創建既能增強又不替代人類決策和創造力的界面。

🔧 技術細節

故障排除

• 模塊未加載：檢查導入路徑和依賴項
• API 密鑰錯誤：驗證.env文件中的配置
• Git 路徑問題：確保已正確添加到系統 PATH
• 啟動失敗：檢查日誌輸出以獲取詳細錯誤信息

📄 擴展閱讀

建議參考以下資源以深入理解 MCP 工具包的功能和用法：

1. 官方文檔
2. 開發者博客
3. 社區論壇

通過遵循這些指南，您應該能夠順利配置和使用 MCP 工具包。如果在過程中遇到任何問題，請隨時參考故障排除部分或聯繫支持團隊尋求幫助。