AI导哈

模型上下文协议服务器

模型上下文协议（MCP）服务器为Claude Desktop提供连接外部数据源和工具的能力，包括GitHub仓库、本地文件系统、网页内容和SQLite数据库的访问。

  • by alkhateeb90
  • Batchfile
  • 本地部署
  • 更新于
在 GitHub 查看 alkhateeb90/claude-mcp-setup

使用说明

Claude MCP设置

此存储库包含连接的配置和设置说明 模型上下文协议（MCP） 服务器连接到克劳德桌面。

什么是MCP？

模型上下文协议（MCP）是一种开放协议，使Claude Desktop能够连接到外部数据源和工具。MCP服务器为Claude提供了额外的功能，如访问您的文件系统、GitHub存储库、数据库等。

可用的MCP服务器

此设置包括以下MCP服务器：

  1. GitHub MCP服务器 -访问和管理GitHub存储库
  2. 文件系统MCP服务器 -在本地计算机上读写文件
  3. 获取MCP服务器 -浏览和获取web内容
  4. SQLite MCP服务器 -查询SQLite数据库

先决条件

在设置MCP服务器之前，请确保您已经：

  • 克劳德桌面 已安装(点击此处下载)
  • Node.js （版本18或更高）- 点击此处下载
  • Git 安装在您的系统上
  • A. GitHub个人访问令牌 （适用于GitHub MCP服务器）

安装说明

第一步：安装Node.js和npm

请确保您已安装Node.js：

node --version
npm --version

如果未安装，请从下载 nodejs.org.

步骤2：安装MCP服务器

MCP服务器将使用npm在全球范围内安装。运行以下命令：

# Install GitHub MCP Server
npm install -g @modelcontextprotocol/server-github

# Install Filesystem MCP Server
npm install -g @modelcontextprotocol/server-filesystem

# Install Fetch MCP Server
npm install -g @modelcontextprotocol/server-fetch

# Install SQLite MCP Server
npm install -g @modelcontextprotocol/server-sqlite

步骤3：创建GitHub个人访问令牌

为了使GitHub MCP服务器正常工作，您需要一个GitHub个人访问令牌：

  1. 首选 GitHub设置>开发者设置>个人访问令牌>令牌（经典）
  2. 点击 “生成新令牌（经典）”
  3. 给它起一个描述性的名字，比如“Claude MCP服务器”
  4. 选择以下范围：
    • repo （完全控制私有存储库）
    • read:org （阅读组织和团队成员）
    • read:user （读取用户配置文件数据）
  5. 点击 “生成令牌”
  6. 复制令牌 -你再也看不到了！

步骤4：配置Claude桌面

配置文件的位置取决于您的操作系统：

  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

从以下位置复制配置 claude_desktop_config.json 在这个存储库中，并将其粘贴到您的Claude Desktop配置文件中。

重要：替换 YOUR_GITHUB_TOKEN_HERE 使用您实际的GitHub个人访问令牌。

步骤5：自定义文件系统路径

在配置文件中，更新文件系统服务器的允许目录以满足您的需求：

"args": [
  "/Users/YOUR_USERNAME/Documents",
  "/Users/YOUR_USERNAME/Projects"
]

将这些路径替换为您希望Claude访问的目录。

步骤6：重新启动克劳德桌面

在保存配置文件之后， 完全退出并重新启动Claude Desktop 以使更改生效。

验证安装

一旦Claude Desktop重新启动，您应该在界面中看到MCP服务器指示灯。您可以通过让Claude执行以下操作来测试连接：

  • 列出您的GitHub存储库
  • 从允许的目录中读取文件
  • 从网站获取内容
  • 查询SQLite数据库（如果有）

故障排除

MCP服务器未显示

  1. 确保您已完全退出并重新启动Claude Desktop（而不仅仅是关闭窗口）
  2. 检查配置文件是否在正确的位置
  3. 验证JSON语法是否有效（没有尾随逗号，引号正确）

GitHub代币问题

  • 确保您已更换 YOUR_GITHUB_TOKEN_HERE 用你的真实代币
  • 验证令牌是否具有正确的权限
  • 检查令牌是否未过期

权限错误

  • 确保文件系统配置中的路径存在
  • 确保您对这些目录具有读/写权限

安全说明

  • 永远不要将您的GitHub令牌提交到公共存储库
  • 保持你的 claude_desktop_config.json 文件安全
  • 仅授予文件系统访问您信任Claude可以修改的目录的权限
  • 查看您授予每个MCP服务器的权限

额外资源

支持

如果您遇到问题：

  1. 检查克劳德桌面日志
  2. 验证是否安装了所有必备组件
  3. 查看上面的故障排除部分
  4. 查阅MCP官方文件

许可证

此配置按原样提供，供个人使用。

相关 MCP