🚀 MCP 服务器设置文档
本指南详细介绍了如何设置与 Claude Desktop 集成的 Model Control Protocol (MCP) 服务器。MCP 服务器可让 Claude 与外部系统和 API（如 AWS 服务、GitHub）交互，从而扩展其能力。
🚀 快速开始
先决条件
- 安装 Python 3.8+
- 安装 Claude Desktop 应用程序
- 安装
uv包管理器 - 具备 Python 和命令行操作的基础知识
📦 安装指南
1. 安装所需包
使用 uv 运行以下命令安装所需包：
uv add MCP --platforms linux/x86_64,linux/arm64,osx/x86_64,osx/arm64,win/x86_64,win/arm64
2. 创建 MCP 配置文件
创建 ~/.config/mcp/config.json 文件，并添加以下内容：
{
"version": "1.0",
"servers": {
"local": {
"host": "localhost",
"port": 5005,
"type": "grpc"
}
},
"apis": {
"aws": {
"region": "us-east-2",
"access_key_id": "YOUR_ACCESS_KEY_ID",
"secret_access_key": "YOUR_SECRET_ACCESS_KEY"
},
"github": {
"token": "YOUR_GITHUB_TOKEN"
}
}
}
3. 启动 MCP 服务器
在终端中运行以下命令启动 MCP 服务器：
uv run MCP --server local
💻 使用示例
测试服务器
验证 MCP 服务器是否正常运行：
curl http://localhost:5005/ping
预期输出：
{
"status": "success",
"message": "MCP server is running"
}
配置 Claude Desktop
1. 打开设置
在 Claude Desktop 中，导航至 Edit > Settings。
2. 添加 MCP 服务器
在 Services 标签下，点击 Add Service 并输入以下信息：
- Name: MCP Server
- Type: Custom
- URL:
http://localhost:5005
3. 应用设置
点击 Add 完成配置。
高级配置
环境变量
在终端中运行以下命令设置环境变量：
export MCP_API_KEY="your_api_key"
自定义依赖项
编辑 ~/.config/mcp/config.json 文件并添加自定义依赖项：
{
"dependencies": {
"custom-package": "^1.0.0"
}
}
运行以下命令安装依赖项：
uv run MCP --install
错误处理
在 ~/.config/mcp/errors.log 文件中查看错误日志。
故障排除
问题：无法连接到服务器
解决方案： 检查服务器状态：
curl http://localhost:5005/ping
确保防火墙允许端口 5005 的流量。
问题：配置文件无效
解决方案：
验证 config.json 文件格式是否正确，必要时使用 JSON 校验工具进行检查。
使用案例
AWS 集成
import boto3
def list_ec2_instances():
ec2 = boto3.client('ec2', region_name='us-east-2')
instances = ec2.describe_instances()
return instances['Reservations']
GitHub 集成
import os
from github import Github
def get_repository_info(repo):
g = Github(os.getenv("GITHUB_TOKEN"))
repo = g.get_repo(repo)
return repo.raw_data
📚 详细文档
安全注意事项
- 避免在代码中硬编码敏感信息。
- 使用环境变量存储机密数据。
- 考虑为 MCP 服务器实施身份验证机制。
- 注意暴露到网络上的功能的安全性。