文档 / usage / mcp-claude

接入 Claude Code

MCP server 在本地跑，通过 stdio 跟 agent 通信。Cursor、Continue、Aider 等支持 MCP 的客户端 形状都一样 —— 只是配置文件位置不同。目前有两个 server：

• 通用 Skill Wiki MCP —— 1 个工具（prime_query）。对接任意编译好的 corpus。空 corpus 起步就用它。
• 前端领域 MCP —— 5 个工具（prime_query、prime_resolve、prime_intent、prime_validate、prime_compile）。和 frontend-design 这个 corpus 配套。

1 · 通用 Skill Wiki MCP（1 个工具）

用于全新 / 空 corpus。只暴露 prime_query。

# 克隆并安装
git clone https://github.com/skill-wiki/prime-system.git
cd prime-system
bun install

# 记下 server 入口的绝对路径：
#   <repo>/packages/mcp-server-core/src/index.ts

然后让客户端跑 bun /abs/path/to/prime-system/packages/mcp-server-core/src/index.ts， 并用 PRIME_DIR 指向你编译好的 corpus 目录。

2 · 前端领域 MCP（5 个工具）

和精选的 frontend-design corpus 配套。在 query 之上加了 resolve / intent / validate / compile。

# 克隆 corpus 仓库
git clone https://github.com/skill-wiki/prime-corpus-frontend.git
cd prime-corpus-frontend
bun install

# server 入口在：
#   <repo>/app/mcp-server-frontend/index.ts

客户端指向 bun /abs/path/to/prime-corpus-frontend/app/mcp-server-frontend/index.ts。 这个仓库自带 corpus 在 compiled-v3-final/；把 PRIME_DIR 指过去。

3 · 编辑器配置

跨客户端 JSON 形状一样 —— 只是文件位置不同。把 args 路径 和 PRIME_DIR 换成你选的 server（1 或 2）的。

Claude Code —— 项目级

项目根目录放一个 .mcp.json，Claude Code 会自动读取。

{
  "mcpServers": {
    "prime": {
      "command": "bun",
      "args": ["/abs/path/to/prime-system/packages/mcp-server-core/src/index.ts"],
      "env": {
        "PRIME_DIR": "/abs/path/to/your/compiled/corpus"
      }
    }
  }
}

用前端 MCP 时，把 args 换成 ["/abs/path/to/prime-corpus-frontend/app/mcp-server-frontend/index.ts"]， PRIME_DIR 指向 .../prime-corpus-frontend/compiled-v3-final。

Claude Code —— 全局

编辑 ~/.claude.json，在顶层 mcpServers 键下加同样的形状：

{
  "mcpServers": {
    "prime": {
      "command": "bun",
      "args": ["/abs/path/to/prime-system/packages/mcp-server-core/src/index.ts"],
      "env": {
        "PRIME_DIR": "/abs/path/to/your/compiled/corpus"
      }
    }
  }
}

Claude Desktop（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "prime": {
      "command": "bun",
      "args": ["/abs/path/to/prime-system/packages/mcp-server-core/src/index.ts"],
      "env": {
        "PRIME_DIR": "/abs/path/to/your/compiled/corpus"
      }
    }
  }
}

Cursor

# Cursor settings → MCP servers → Add
Server name: prime
Command:     bun
Args:        /abs/path/to/prime-system/packages/mcp-server-core/src/index.ts
Env:         PRIME_DIR=/abs/path/to/your/compiled/corpus

Continue

编辑 ~/.continue/config.json：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "bun",
          "args": ["/abs/path/to/prime-system/packages/mcp-server-core/src/index.ts"]
        },
        "env": {
          "PRIME_DIR": "/abs/path/to/your/compiled/corpus"
        }
      }
    ]
  }
}

测试连接

重启客户端。连上以后，问 agent 一个 corpus 知道的事情：

"corpus 里哪些原子描述了 'pan sauce'？用 prime_query。"

agent 应当返回一组原子，每个带 kind 和投影路径， 接着可能调 Read 去读特定的正文。

排查