Hello MCP Nc5

🚀 Hello - MCP協議項目

本項目提供了一個簡單的模型控制協議實現，能幫助您瞭解MCP協議的工作原理，助力複雜AI系統的集成與開發。

🚀 快速開始

安裝使用

1. 克隆項目倉庫：

git clone https://github.com/yourusername/hello-mcp.git
cd hello-mcp

2. 創建虛擬環境並安裝依賴：

python -m venv env
source env/bin/activate  # Mac/Linux或env\Scripts\activate.bat Windows
pip install -r requirements.txt

配置文件

編輯config.yaml配置文件，填寫以下信息：

• API訪問密鑰：從DeepSeek獲取的API密鑰

啟動服務

uvicorn server:app --reload

✨ 主要特性

MCP協議簡介

• 標準化AI模型交互協議
• 統一的工具調用規範
• 簡化複雜AI系統集成
• 支持多模型協作平臺

項目特點

客戶端功能

• 交互式命令行聊天界面
• 支持MCP工具註冊與發現
• 集成DeepSeek API接口

服務端功能

• 提供基礎MCP協議實現
• 支持自定義工具擴展
• 內置示例工具集合

💻 使用示例

基礎用法

註冊MCP工具：

from mcp.client import MCPClient

client = MCPClient()
client.register_tool('tool_name', 'http://localhost:8000')

📚 詳細文檔

調試技巧

1. 檢查服務啟動日誌，確認API接口正常運行。
2. 使用curl命令測試API接口：

curl http://localhost:8000/docs

MCP協議問答

什麼是MCP協議？

• 問題1：MCP解決了哪些問題？

  • 標準化AI模型交互協議
  • 統一工具調用規範
  • 簡化複雜AI系統集成
  • 支持多模型協作

• 問題2：MCP的發展歷程？

  • 2023年：由Anthropic提出
  • 2024年：開源實現開始流行
  • 2025年：成為事實標準
  • 現在：廣泛應用於AI系統集成

MCP與函數調用的區別

項目常見問題

配置問題

1. DeepSeek API配置錯誤？

   • 檢查config.yaml中api_key是否正確填寫

2. API密鑰格式錯誤？

   • 確保沒有多餘的空格或引號
   • 可嘗試重新生成API密鑰

服務啟動問題

1. 端口被佔用？

lsof -i :8000    # 查看佔用進程
kill -9 PID       # 殺死進程後重啟服務

2. 修改默認端口？ 修改server.py中的app = FastAPI(...)配置

項目擴展開發

添加新工具

@app.post("/tool/{tool_name}")
async def handle_tool(tool_name: str, request_data: dict):
    # 實現自定義邏輯

📄 貢獻指南

1. Fork本倉庫
2. 創建功能分支
3. 提交代碼
4. 創建Pull Request

歡迎通過Issues或Pull Request參與項目開發！