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 架构特性

• MCP 服务器通常使用 Unix 套接字或标准输入输出进行通信。
• 主要设计用于本地使用，而非 HTTP/REST API。
• 团队范围内的访问需要额外的集成工作。
• MCP 服务器可以根据客户端请求支持多个上下文/资源。

Git MCP 服务器功能

• 初始化仓库：使用 git_init 工具创建新仓库。
• 获取状态：通过 git_status 检查仓库状态。
• 提交更改：使用 git_commit 提交文件到仓库。

📦 安装指南

单人开发

根据文档安装必要的库和工具，运行服务器命令如下：

mcp_server_git --port 8000

团队部署

在 Kubernetes 集群中部署 MCP 服务器，相关配置文件位于 deployments/git/ 目录下。

💻 使用示例

基础用法

单人开发客户端使用示例

# 初始化新仓库
git_init(repo_path="/path/to/repo")

# 获取仓库状态
git_status(repo_path="/path/to/repo")

团队客户端配置示例

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

高级用法

与 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)

📚 详细文档

项目结构

.
├── 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

实验性 Kubernetes 部署

1. 部署服务器：

kubectl apply -f deployments/git/k8s-deployment.yaml

2. 暴露服务：

kubectl expose deployment mcp-server --port 8000

3. 访问服务：

kubectl get services
# 获取EXTERNAL-IP，然后在浏览器中打开 http://<external-ip>:8000

新增 MCP 服务器的方法

1. 创建新目录：在 servers/ 文件夹下新建一个文件夹，例如 my_server/。
2. 实现接口：继承自 MCPServer 类并实现所需方法。
3. 注册服务器：更新主 README.md 文档以记录新的服务器实现。

故障排除

错误：“/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 服务器的架构特点：

• MCP 服务器通常使用 Unix 套接字或标准输入输出进行通信。
• 主要设计用于本地使用，而非 HTTP/REST API。
• 团队范围内的访问需要额外的集成工作。
• MCP 服务器可以根据客户端请求支持多个上下文/资源。

📄 许可证

文档未提及相关许可证信息。

🔜 下一步建议

1. 探索适合团队环境的自定义 MCP 服务器实现。
2. 调查 WebSocket 或 gRPC 协议以实现网络通信。
3. 开发身份验证和授权层。
4. 创建能够与网络可访问的 MCP 服务器交互的客户端适配器。

📚 参考资料

• 模型上下文协议
• MCP Python SDK
• MCP Git 服务器