使用说明
MCP克劳德
本地MCP服务器与Claude Desktop MCP客户端集成。
什么是MCP?
模型上下文协议(MCP)是一个开放标准,使AI助手能够安全地访问外部数据和工具。它允许Claude Desktop通过标准化的服务器连接到各种服务和资源。
安装说明
1.安装克劳德桌面
从Anthropic官方网站下载并安装Claude Desktop。
2.配置MCP服务器
Claude Desktop使用配置文件来管理MCP服务器。配置文件的位置取决于您的操作系统:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
3.配置文件
创建或编辑 claude_desktop_config.json 具有以下配置的文件:
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT_HERE"
}
}
}
}
4.创建GitHub个人访问令牌
- 首选 GitHub设置>开发者设置>个人访问令牌
- 点击“生成新令牌(经典)”
- 设置适当的到期日期
- 选择以下范围:
repo(完全控制私有存储库)user(读取用户配置文件数据)workflow(更新GitHub Action工作流)
- 点击“生成令牌”
- 复制令牌并替换
YOUR_GITHUB_PAT_HERE在配置中
5.重新启动克劳德桌面
保存配置文件后,重新启动Claude Desktop以加载新的MCP服务器。
特性
配置后,Claude Desktop将可以访问GitHub功能,包括:
- 存储库管理
- 文件 操作
- 问题跟踪
- 拉取请求管理
- 代码搜索
- 用户和组织管理
故障排除
常见问题
- 未找到配置文件:确保文件位于操作系统的正确位置
- 无效令牌:验证您的GitHub PAT是否有效,是否具有正确的权限
- 服务器未加载:检查Node.js是否已安装,npx是否可用
- 权限不足:确保PAT具有您要执行的操作所需的范围
验证
要验证设置是否正常工作:
- 打开克劳德桌面
- 开始新的对话
- 试着让Claude帮助GitHub运营
- 你应该在Claude的回复中看到与GitHub相关的工具
安全说明
- 确保您的GitHub个人访问令牌安全
- 从不将令牌提交到版本控制
- 考虑对敏感数据使用环境变量
- 定期轮换代币以提高安全性
其他MCP服务器
此配置可以扩展到包括其他MCP服务器。热门选项包括:
- 用于本地文件访问的文件系统服务器
- 用于数据管理的数据库服务器
- 用于外部服务集成的API服务器
贡献
请随时提交问题和增强请求!
许可证
这个项目是开源的,可以在MIT许可证下使用。
