Model Context Protocol (mcp) 16r

🚀 模型上下文指南

本項目提供了模型上下文協議相關的工具和服務，幫助用戶通過自然語言與系統進行交互，實現文件操作、網頁內容處理、系統命令執行等功能。

🚀 快速開始

項目結構

- mcp/
  - clients/
    - mcp-client/
      - langchain_mcp_client_wconfig.py
      - theailanguage_config.json
      - .env
  - servers/
    - terminal_server/
    - memory_server/

本地設置指南

先決條件

• Python 3.9+
• Node.js 16+
• Google API Key
• UV 包管理器

安裝步驟

1. 克隆倉庫：

git clone https://github.com/Techiral/mcp.git
cd mcp

2. 創建並激活 Python 環境：

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

3. 配置環境變量：

echo "GOOGLE_API_KEY=your_key_here" > clients/mcp-client/.env
echo "THEAILANGUAGE_CONFIG=clients/mcp-client/theailanguage_config.json" >> clients/mcp-client/.env

4. 安裝 Node.js 服務器：

npm install -g @modelcontextprotocol/server-memory @modelcontextprotocol/server-filesystem

驗證檢查列表

• [x] 倉庫已克隆
• [x] Python 虛擬環境創建並激活
• [x] Python 依賴項安裝完成
• [x] .env 文件配置完成
• [x] Node.js 服務器安裝完成

💻 使用示例

基礎用法

1. 啟動客戶端：

python clients/mcp-client/langchain_mcp_client_wconfig.py

2. 輸入自然語言請求並接收響應。

命令示例

文件操作

創建名為 example.txt 的文件
搜索所有 Python 文件中的 "function"
計算 main.py 中的行數

網頁內容

總結 https://example.com
提取新聞站點的頭條新聞

系統命令

列出當前目錄中的文件
檢查 Python 版本
運行 git status

內存操作

記住我的最愛顏色是藍色
顯示設置的偏好設置
顯示最近的命令

📚 詳細文檔

服務器配置

關鍵配置文件

• theailanguage_config.json：主要服務器配置文件
• .env：環境變量文件

示例服務器配置

{
  "terminal_server": {
    "command": "uv",
    "args": ["run", "servers/terminal_server/terminal_server.py"]
  },
  "memory": {
    "command": "npx.cmd",
    "args": ["@modelcontextprotocol/server-memory"],
    "port": 3000
  }
}

故障排除

常見問題

1. 網絡連接問題：

   • 檢查網絡是否正常。
   • 確保服務器正在運行。

2. 依賴項未安裝：

   • 檢查並安裝所有必要的包。

3. 配置文件錯誤：

   • 確保配置文件格式正確。
   • 檢查環境變量是否設置正確。

如何貢獻

提交代碼

1. 創建功能分支：

git checkout -b feature/new-feature

2. 提交更改：

git add .
git commit -m "添加新功能"

3. 推送到遠程倉庫：

git push origin feature/new-feature

4. 創建拉取請求到主分支。

問題報告

1. 創建問題報告：

   • 描述問題。
   • 提供復現步驟。

2. 提交 Pull Request：

   • 包含修復代碼。
   • 解釋修復內容。

模型上下文協議

協議說明

• 數據格式：JSON
• 通信方式：HTTP
• 接口版本：1.0

示例接口調用

POST /api/v1/model_context HTTP/1.1
Content-Type: application/json

{
  "model_id": "gpt-3",
  "context": {
    "user_input": "如何使用Python？"
  }
}

術語表

感謝使用模型上下文指南！如需更多信息，請訪問我們的文檔頁面。