AI导哈

跨平台MCP配置服务

该服务用于在多台机器上复制Claude Desktop MCP配置，连接WordPress.com和GitHub平台，作为AI的扩展文件系统。

  • by ludwa6
  • Shell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ludwa6/claude-mcp-setup

使用说明

Claude MCP安装文档

目的： 在多台机器上复制Claude Desktop MCP配置（英特尔MacBook、苹果Silicon Mac Mini和未来的设备）

业主： Walt（65岁，自90年代中期以来担任IT/WebDev经理）

最后更新时间： 2024年12月9日

概述

该设置连接了三个关键平台：

  • WordPress.com -用于人类可读内容的CMS
  • GitHub -AI可读文档库（80%降价，20%代码）
  • 克劳德桌面 -具有MCP访问两个平台的AI助手

目标是将MCP用作扩展的“文件系统”，将AI有限的上下文窗口与广泛的、当前的、相关的数据连接起来。

当前配置

先决条件

两台机器都需要：

  • Node.js和npm （用于通过npx运行MCP服务器）
  • 克劳德桌面 安装
  • GitHub个人访问令牌 （适用于GitHub MCP）
  • WordPress.com帐户 （通过OAuth进行身份验证）

已配置MCP服务器

1.WordPress.com MCP服务器

  • 包裹： @automattic/mcp-wpcom-remote@latest
  • 身份验证： OAuth（基于浏览器，首次运行）
  • 访问权限： 远程连接到WordPress.com网站

2.GitHub MCP服务器

  • 包裹： @modelcontextprotocol/server-github
  • 身份验证： 个人访问令牌（PAT）
  • 模式： 远程（GitHub API，而不是本地转发）

新机器的设置说明

步骤1：安装Node.js（如果尚未安装）

对于英特尔Mac：

# Check if already installed
node --version
npm --version

# If not installed, use Homebrew
brew install node

对于苹果Silicon Mac：

# Same as Intel - Homebrew handles architecture
brew install node

第二步：获取GitHub个人访问令牌

您需要为每台机器创建一个新令牌（或使用共享令牌-请参阅下面的安全注意事项）。

  1. 首选https://github.com/settings/tokens
  2. 点击“生成新令牌”→ “生成新令牌（经典）”
  3. 设置过期时间（建议90天，带日历提醒重新生成）
  4. 选择范围：
    • repo （所有回购访问）
    • read:org （如果你使用org repos）
    • read:user （用户资料信息）
  5. 生成和 立即复制令牌 （你再也看不见了）

步骤3：配置Claude桌面

创建/编辑配置文件：

# Open the config file in your preferred editor
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Or use nano if you prefer
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

粘贴此配置（替换 YOUR_GITHUB_TOKEN_HERE 使用您的实际令牌）：

{
  "mcpServers": {
    "wpcom": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wpcom-remote@latest"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN_HERE",
        "GITHUB_MCP_SERVER_MODE": "remote"
      }
    }
  }
}

步骤4:重新启动克劳德桌面

  1. 完全退出克劳德桌面（Cmd+Q）
  2. 重新打开克劳德桌面
  3. 首次运行时，WordPress MCP将在浏览器中提示进行OAuth身份验证
  4. GitHub MCP应立即使用该令牌

步骤5：验证设置

在新的Claude聊天中，测试两个连接：

For WordPress: "List my WordPress.com sites"
For GitHub: "List my GitHub repositories"

英特尔和苹果硅的区别

好消息： 没有！

这 npx 该方法会自动下载每种架构的相应二进制文件。两台机器使用相同的配置。

安全注意事项

GitHub代币存储

当前方法： 令牌以纯文本形式存储在配置文件中

安全影响：

  • 任何有权访问您Mac的人都可以读取此令牌
  • Token具有完全的回购访问权限
  • 如果令牌被泄露，请立即在GitHub设置中撤销它

更好的方法（可选）：

  • 使用环境变量而不是硬编码令牌
  • 在macOS钥匙串中存储令牌
  • 每台机器使用不同的令牌（更容易跟踪/撤销）

要改用环境变量，请执行以下操作：

  1. 添加到您的 ~/.zshrc:

    export GITHUB_PERSONAL_ACCESS_TOKEN="your_token_here"

  2. 修改配置以引用它：

    "env": {
  "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}",
  "GITHUB_MCP_SERVER_MODE": "remote"
}

故障排除

MCP服务器未显示

  1. 检查是否安装了Node.js： node --version
  2. 检查配置文件语法（有效的JSON）
  3. 完全重新启动克劳德桌面
  4. 检查Console.app中的Claude错误

GitHub连接失败

  1. 验证令牌在以下位置有效https://github.com/settings/tokens
  2. 检查令牌的作用域是否正确（repo，read:org，read:user）
  3. 确保令牌未过期
  4. 手动测试令牌：
    curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/user

WordPress连接失败

  1. 清除浏览器缓存，然后重试OAuth流
  2. 检查您是否已在浏览器中登录WordPress.com
  3. 确保您的帐户关联了网站

npx故障或挂起

  1. 清除npm缓存： npm cache clean --force
  2. 检查互联网连接
  3. 尝试手动运行： npx -y @modelcontextprotocol/server-github

文件位置参考

项目 路径
克劳德配置 ~/Library/Application Support/Claude/claude_desktop_config.json
MCP缓存（临时） ~/.npm/_npx/
Node.js /usr/local/bin/node （英特尔）或 /opt/homebrew/bin/node （苹果硅）

后续步骤

立即

  • []在Mac Mini上复制安装程序
  • []在Mac Mini上测试两个MCP连接
  • []记录所需的任何其他步骤

未来的增强功能

  • []为安装创建自动化脚本
  • []构建自定义MCP服务器以捕获Claude Desktop输出
  • []通过Keychain实现安全令牌管理
  • []添加iPad/iPhone访问策略

备注

  • 两台MCP服务器都使用 npx -y 这意味着它们按需运行，无需永久安装
  • Intel和Apple Silicon的配置完全相同
  • 只有GitHub令牌需要保密/安全
  • WordPress OAuth是特定于机器的（需要在每个设备上进行身份验证）

相关 MCP