MCP Skills Bridge

MCP技能桥与MCPorter

基于技能的使用方法 麦波特 克劳德代码。该系统通过Claude的技能路由系统，仅在需要时加载MCP工具文档，从而保存上下文令牌。

问题

MCP服务器公开了许多工具，但将它们的所有模式和文档加载到每个Claude对话中会浪费上下文。你最终会得到数千个克劳德可能永远不会使用的工具定义。

解决方案

本项目使用两层系统：

1. CLAUDE.md -一个轻量级的路由器（约50行），将触发短语与技能文件相匹配
2. 技能档案 -每个MCP的详细文档，仅在相关时加载

当你说“添加按钮组件”时，Claude会读取Claude.md，看到它与shadcn触发器匹配，然后加载完整的shadcn技能文件。通过MCPorter CLI而不是本机MCP连接调用工具。

项目结构

~/.claude/
├── CLAUDE.md              # Router with trigger phrases
└── skills/
    ├── mcp-setup.md       # Meta-skill: how to add new MCPs
    └── mcp/               # MCP-specific skill files
        ├── context7-docs.md
        ├── blender-mcp.md
        └── shadcn-mcp.md

注： 技能文件可以在子目录中。只需相应地更新CLAUDE.md中的路径（例如。， ~/.claude/skills/mcp/blender-mcp.md).

安装

1.安装MCPorter

npm install -g mcporter

2.将技能复制到您的Claude配置

复制 CLAUDE.md 和 skills/ 文件夹到您的Claude配置目录：

macOS/Linux/Git Bash：

# Create the skills directory
mkdir -p ~/.claude/skills

# Copy files
cp CLAUDE.md ~/.claude/
cp -r skills/* ~/.claude/skills/

Windows（cmd.exe）：

mkdir %USERPROFILE%\.claude\skills\mcp
copy CLAUDE.md %USERPROFILE%\.claude\
xcopy skills %USERPROFILE%\.claude\skills\ /E /I

Windows（PowerShell）：

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\mcp"
Copy-Item CLAUDE.md "$HOME\.claude\"
Copy-Item -Recurse skills\* "$HOME\.claude\skills\"

3.配置您的MCP服务器

将MCP服务器添加到MCP配置文件中（例如。， ~/.cursor/mcp.json):

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp"]
    },
    "shadcn": {
      "command": "npx",
      "args": ["-y", "@anthropic/shadcn-mcp"]
    }
  }
}

4.验证设置

# List available servers
npx mcporter list

# List tools for a server
npx mcporter list context7 --all-parameters

用法

自然地和克劳德谈谈。路由器处理其余部分：

运作原理

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────┐
│ User prompt │ -> │  CLAUDE.md  │ -> │ Skill file  │ -> │ MCPorter│
│             │    │  (router)   │    │ (full docs) │    │  CLI    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────┘
                         │                   │
                   ~50 lines            Only loaded
                   always loaded        when needed

MCPorter命令

# List all configured servers
npx mcporter list

# List tools with parameters
npx mcporter list  --all-parameters

# Call a tool
npx mcporter call . param:"value"

# Examples
npx mcporter call context7.resolve-library-id libraryName:"react"
npx mcporter call shadcn.search_items_in_registries query:"button"

添加新MCP

使用随附的 mcp-setup.md 技能。告诉克劳德：

“添加GitHub MCP服务器”

或者遵循手动流程：

1. 将服务器添加到MCP配置中
2. 发现工具： npx mcporter list --all-parameters
3. 测试工具 -MCP通常有未记录的要求
4. 在以下位置创建技能档案 ~/.claude/skills/mcp/.md
5. 将路由器条目添加到CLAUDE.md

看 技能/mcp-setup.md 完整的工作流程。

技能文件模板

# [Server Name] Skill

Use this skill when [describe trigger conditions].

## When to Use
- [Condition 1]
- [Condition 2]

## Commands

### [Tool Name]
\`\`\`bash
npx mcporter call . param:"value"
\`\`\`

## Common Workflows

### [Workflow Name]
1. Step 1
2. Step 2

## Quirks & Gotchas
- [Document hidden requirements discovered during testing]

包括示例技能

为什么选择MCPorter？

麦波特 弥合MCP服务器和基于CLI的工作流之间的差距：

• 不需要本机连接 -适用于任何Claude界面
• 可测试的 -直接在终端中调试MCP调用
• 可组合 -与其他CLI工具链接
• 透明 -准确查看发送/接收的内容

提示

• 将CLAUDE.md控制在约50行以内-每次对话都会加载它
• 将所有详细文档放入技能文档中
• 在编写技能文件之前测试MCP工具——它们通常有未记录的要求
• 使用 Quirks & Gotchas 记录变通方法的部分
• 如果你有很多技能，可以将其组织到子目录中

许可证

麻省理工学院