MCP Examples

🚀 MCP 服務器團隊部署方案

本項目聚焦於團隊使用的 Model Context Protocol (MCP) 服務器的部署配置與自定義實現，旨在為團隊提供高效、安全的 MCP 服務器使用方案。

🚀 快速開始

單人開發（簡單）

1. 安裝依賴：依據文檔安裝必要的庫和工具。
2. 運行服務器：

   mcp_server_git --port 8000
   

3. 使用客戶端：

   # 初始化新倉庫
   git_init(repo_path="/path/to/repo")
   
   # 獲取倉庫狀態
   git_status(repo_path="/path/to/repo")
   

團隊範圍內的訪問

1. 配置服務器：在 Kubernetes 集群中部署 MCP 服務器。
2. 更新客戶端配置：

   mcp_client --server_url http://mcp-server.example.com
   

3. 權限管理：實施身份驗證和授權機制，保障團隊成員的安全訪問。

✨ 主要特性

• MCP 服務器採用 Unix 套接字或標準輸入輸出通信，主要用於本地使用，非 HTTP/REST API。
• 支持根據客戶端請求處理多個上下文/資源。
• 可通過 Kubernetes 集群實現團隊範圍內的訪問。

📦 安裝指南

單人開發

按文檔安裝必要庫和工具，運行 mcp_server_git --port 8000 啟動服務器。

團隊部署

在 Kubernetes 集群中部署 MCP 服務器，更新客戶端配置 mcp_client --server_url http://mcp-server.example.com，並進行權限管理。

💻 使用示例

基礎用法

單人開發客戶端使用

# 初始化新倉庫
git_init(repo_path="/path/to/repo")

# 獲取倉庫狀態
git_status(repo_path="/path/to/repo")

與 Cursor 集成示例

# 步驟 1: 安裝依賴
pip install mcp-client

# 步驟 2: 配置
在項目根目錄下創建 `mcp_config.json`：
```json
{
  "server_url": "http://mcp-server.example.com",
  "api_key": "your_api_key_here"
}

# 步驟 3: 插件實現
from mcp_client import MCPClient

client = MCPClient()
response = client.git_status(repo_path="/path/to/repo")
print(response.status)

高級用法

團隊範圍內的訪問

# 配置服務器：在 Kubernetes 集群中部署 MCP 服務器
# 更新客戶端配置
mcp_client --server_url http://mcp-server.example.com

實驗性 Kubernetes 部署

# 部署服務器
kubectl apply -f deployments/git/k8s-deployment.yaml

# 暴露服務
kubectl expose deployment mcp-server --port 8000

# 訪問服務
kubectl get services
# 獲取EXTERNAL-IP，然後在瀏覽器中打開 http://<external-ip>:8000

📚 詳細文檔

理解 MCP 架構

• MCP 服務器通常使用 Unix 套接字或標準輸入輸出進行通信。
• 主要設計用於本地使用，而非 HTTP/REST API。
• 團隊範圍內的訪問需要額外的集成工作。
• MCP 服務器可根據客戶端請求支持多個上下文/資源。

項目結構

.
├── deployments/         # Kubernetes 部署配置（實驗性）
│   └── git/             # Git MCP 服務器部署
│       ├── Dockerfile
│       ├── k8s-deployment.yaml
│       ├── k8s-ingress.yaml
│       ├── deploy.sh
│       └── README.md
│
└── servers/             # 自定義 MCP 服務器實現
    ├── git/             # Git MCP 服務器自定義實現（如果需要）
    │   └── README.md
    └── README.md

新增 MCP 服務器的方法

1. 創建新目錄：在 servers/ 文件夾下新建一個文件夾，例如 my_server/。
2. 實現接口：繼承自 MCPServer 類並實現所需方法。
3. 註冊服務器：更新主 README.md 文檔以記錄新的服務器實現。

與 Cursor 的集成（示例）

假設開發一個名為 my_plugin 的新工具，需與 MCP 服務器交互：

1. 安裝依賴：

pip install mcp-client

2. 配置：在項目根目錄下創建 mcp_config.json：

{
  "server_url": "http://mcp-server.example.com",
  "api_key": "your_api_key_here"
}

3. 插件實現：

from mcp_client import MCPClient

client = MCPClient()
response = client.git_status(repo_path="/path/to/repo")
print(response.status)

故障排除

錯誤：“/repos 不是有效的 Git 倉庫”

問題：ERROR:mcp_server_git.server:/repos 不是有效的 Git 倉庫 解決方法：

1. 使用 git_init 工具創建倉庫：

   git_init(repo_path="/path/to/repo")
   

2. 在後續操作中指定此路徑：

   git_status(repo_path="/path/to/repo")
   

通信問題

• 檢查服務器是否運行：kubectl get pods 或 ps aux | grep mcp_server_git
• 確保客戶端配置正確指向目標地址
• 驗證對倉庫目錄的權限

🔧 技術細節

MCP 服務器架構設計上主要使用 Unix 套接字或標準輸入輸出進行通信，這種設計使其更適合本地使用場景。對於團隊範圍內的訪問，由於其並非基於 HTTP/REST API，需要額外的集成工作，例如在 Kubernetes 集群中部署以實現團隊成員的訪問。在功能上，MCP 服務器能夠根據客戶端請求支持多個上下文/資源，為不同的業務需求提供了靈活性。

📄 許可證

文檔未提及相關許可證信息。

🔜 下一步建議

1. 探索適配團隊環境的自定義 MCP 服務器實現。
2. 調研 WebSocket 或 gRPC 協議以實現網絡通信。
3. 開發身份驗證和授權層。
4. 創建可與網絡可訪問的 MCP 服務器交互的客戶端適配器。

📚 參考資料

• 模型上下文協議
• MCP Python SDK
• MCP Git 服務器