大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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

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

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

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

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

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

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

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

以 Filesystem 为例：

字段 值 Name filesystem Command npx Args -y, @modelcontextprotocol/server-filesystem, /Users/你的用户名/Documents

点击 Create 完成添加。

准备 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 Command Args 环境变量 Filesystem npx -y, @modelcontextprotocol/server-filesystem, 路径 – GitHub npx -y, @modelcontextprotocol/server-github GITHUB_TOKEN Playwright npx @playwright/mcp@latest – PostgreSQL npx -y, @modelcontextprotocol/server-postgres, 连接字符串 – SQLite npx -y, @modelcontextprotocol/server-sqlite, 数据库路径 – Brave Search npx -y, @modelcontextprotocol/server-brave-search BRAVE_API_KEY

# 将令牌导出为环境变量
export MCPR_TOKEN=“mcpr_BTqZdKEmF91IuhcxENV9PdT75-3ayhHe”

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

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

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”
     }
   }
 }
}

{
  “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
     …

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

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

/.claude.json：

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

/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 
     
                    # 查看详情 
      
claude mcp remove 
       
                   # 删除 MCP 
        
​ 
# 添加 MCP（不同作用域） 
claude mcp add -s user 
           
             – 
                  # 全局 
claude mcp add -s project 
              
                – 
                  # 项目级（Git 追踪） 
claude mcp add 
                 
                   – 
                                # 本地（默认） 
​ 
# 从 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)