Mac 端 MCP Router + Claude Code 配置教程

作者

MCP Router 是一个 MCP Server 统一管理工具，提供 GUI 管理界面、Projects/Workspaces 项目管理、请求日志分析等功能。本文介绍如何在 macOS 环境下安装配置 MCP Router，并与 Claude Code 集成，实现 MCP Server 的集中管理和多项目配置。

什么是 MCP Router

MCP Router 是一个 MCP Server 统一管理工具，它解决了以下问题：

问题MCP Router 解决方案
每个应用单独配置 MCP统一在一处管理
无法查看 MCP 调用日志提供完整请求日志
配置分散难以维护集中化 GUI 管理
无法按项目切换 MCPProjects + Workspaces 管理

环境准备

1. 安装 Node.js（最新 LTS 版本）

MCP Router CLI 依赖 Node.js，推荐使用 nvm 管理版本：

# 安装 nvm（如果没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
​
# 重新加载 shell 配置
source ~/.zshrc  # 或 source ~/.bashrc
​
# 安装最新 LTS 版本
nvm install --lts
nvm use --lts
nvm alias default node
​
# 验证安装
node -v
npm -v
npx -v

2. 确认 npx 路径

记录 npx 的绝对路径，后续配置可能用到：

which npx
# 输出示例：/Users/xxx/.nvm/versions/node/vXX.X.X/bin/npx

3. 安装 Claude Code

# 使用 npm 全局安装
npm install -g @anthropic-ai/claude-code
​
# 验证安装
claude --version

安装 MCP Router

  1. 访问 MCP Router Releases
  2. 下载最新版 .dmg 文件（如 MCP-Router-x.x.x-arm64.dmg）
  3. 打开 .dmg，将 MCP Router 拖入 Applications 文件夹

配置 MCP Router

第一步：添加 MCP Server

打开 MCP Router，点击 + Add MCP Server，选择添加方式：

方式 A：Manual（手动配置）

以 Filesystem 为例：

字段值
Namefilesystem
Commandnpx
Args-y, @modelcontextprotocol/server-filesystem, /Users/你的用户名/Documents

点击 Create 完成添加。

方式 B：JSON 导入

准备 JSON 配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/你的用户名/Documents",
        "/Users/你的用户名/Desktop"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_你的GitHub_Token"
      }
    }
  }
}

在 MCP Router 中选择 JSON 方式，粘贴上述配置导入。

第二步：常用 MCP Server 配置参考

MCP ServerCommandArgs环境变量
Filesystemnpx-y, @modelcontextprotocol/server-filesystem, 路径–
GitHubnpx-y, @modelcontextprotocol/server-githubGITHUB_TOKEN
Playwrightnpx@playwright/mcp@latest–
PostgreSQLnpx-y, @modelcontextprotocol/server-postgres, 连接字符串–
SQLitenpx-y, @modelcontextprotocol/server-sqlite, 数据库路径–
Brave Searchnpx-y, @modelcontextprotocol/server-brave-searchBRAVE_API_KEY

第三步：获取连接 Token

  1. 点击左侧 MCP 应用集成
  2. 找到 Claude
  3. 点击 使用方法
# 将令牌导出为环境变量
export MCPR_TOKEN="mcpr_BTqZdKEmF91IuhcxENV9PdT75-3ayhHe"

配置 Claude Code

方式一：命令行添加（推荐）

全局配置（所有项目生效）

claude mcp add -s user mcp-router -- \
  env MCPR_TOKEN=mcpr_BTqZdKEmF91IuhcxENV9PdT75-3ayhHe \
  npx -y @mcp_router/cli connect

项目级配置（仅当前项目生效，可提交到 Git）

cd ~/your-project
​
claude mcp add -s project mcp-router -- \
  env MCPR_TOKEN=mcpr_你的Token \
  npx -y @mcp_router/cli connect --project your-project-name

本地配置（仅当前项目，不提交到 Git）

cd ~/your-project
​
claude mcp add mcp-router -- \
  env MCPR_TOKEN=mcpr_你的Token \
  npx -y @mcp_router/cli connect --project your-project-name

方式二：直接编辑配置文件

全局配置 ~/.claude.json

vi ~/.claude.json
{
  "mcpServers": {
    "mcp-router": {
      "command": "npx",
      "args": ["-y", "@mcp_router/cli", "connect"],
      "env": {
        "MCPR_TOKEN": "mcpr_你的Token"
      }
    }
  }
}

指定 MCP Router Project

{
  "mcpServers": {
    "mcp-router": {
      "command": "npx",
      "args": ["-y", "@mcp_router/cli", "connect", "--project", "web-app"],
      "env": {
        "MCPR_TOKEN": "mcpr_你的Token"
      }
    }
  }
}

项目级配置（项目根目录 .mcp.json）

{
  "mcpServers": {
    "mcp-router": {
      "command": "npx",
      "args": ["-y", "@mcp_router/cli", "connect", "--project", "my-project"],
      "env": {
        "MCPR_TOKEN": "mcpr_你的Token"
      }
    }
  }
}

配置作用域说明

作用域命令参数配置文件位置Git 追踪
user（全局）-s user~/.claude.json–
project（项目级）-s project项目根目录 .mcp.json✅ 是
local（默认）无项目 .claude/ 目录❌ 否

优先级：local > project > user

验证配置

# 查看已配置的 MCP
claude mcp list
​
# 启动 Claude Code
claude
​
# 在 Claude Code 中检查 MCP 状态
/mcp

成功连接后显示：

MCP Servers:
  ● mcp-router (connected)
    Tools:
      - filesystem_read_file
      - filesystem_write_file
      - github_create_issue
      ...

多项目配置

场景：不同项目使用不同的 MCP 组合

项目结构：
├── ~/projects/web-app      → 需要 filesystem, playwright
├── ~/projects/api-server   → 需要 filesystem, github, postgresql  
└── ~/projects/scripts      → 需要 filesystem, aws

全局通用 + 项目自定义

步骤 1：MCP Router 中创建 Projects

MCP Router:
├── 📁 common（通用）
│   ├── filesystem
│   └── github
├── 📁 web-app
│   └── playwright
├── 📁 api-server
│   └── postgresql
└── 📁 scripts
    └── aws

步骤 2：全局配置通用 MCP

~/.claude.json：

{
  "mcpServers": {
    "common": {
      "command": "npx",
      "args": ["-y", "@mcp_router/cli", "connect", "--project", "common"],
      "env": {
        "MCPR_TOKEN": "mcpr_你的Token"
      }
    }
  }
}

步骤 3：各项目配置特定 MCP

~/projects/web-app/.mcp.json：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/xxx/projects/web-app"]
    }
  }
}

~/projects/api-server/.mcp.json：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/xxx/projects/api-server"]
    }
  }
}

常用命令速查

# MCP 管理
claude mcp list                    # 列出所有 MCP
claude mcp get <name>              # 查看详情
claude mcp remove <name>           # 删除 MCP
​
# 添加 MCP（不同作用域）
claude mcp add -s user <name> -- <command>      # 全局
claude mcp add -s project <name> -- <command>   # 项目级（Git 追踪）
claude mcp add <name> -- <command>              # 本地（默认）
​
# 从 Claude Desktop 导入
claude mcp add-from-claude-desktop
​
# 调试
claude --mcp-debug                 # 调试模式启动
MCP_TIMEOUT=10000 claude           # 设置超时时间

快速检查清单

  • Node.js 已安装最新 LTS 版本（node -v）
  • Claude Code 已安装（claude --version）
  • MCP Router 桌面应用已安装并运行
  • MCP Router 中已添加 MCP Server
  • 已获取 MCP Router Token
  • Claude Code 配置已添加（claude mcp list）
  • /mcp 显示连接成功

参考资源

教程更新日期：2025年12月 | 适用系统：macOS (Intel / Apple Silicon)

发表评论