MCP 使用说明

Posted on Apr 1, 2026

MCP Guide

这份文档分三部分：

各 CLI 的 MCP 配置说明（路径、格式、常用命令）
一张异同对照表，方便快速选型和排障

各 CLI 配置说明

Cursor

配置文件：

~/.cursor/mcp.json（全局）
.cursor/mcp.json（项目）

核心结构（mcpServers）：

{
  "mcpServers": {
    "context7": {
      "url": "<https://mcp.context7.com/mcp>",
      "headers": { "CONTEXT7_API_KEY": "..." }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": { "NODE_ENV": "production" }
    }
  }
}

Claude Code

推荐命令管理：

claude mcp add -s user --transport http notion <https://mcp.notion.com/mcp>
claude mcp add -s user --transport stdio --env='API_KEY=your_key' my-local -- npx -y @modelcontextprotocol/server-memory
claude mcp list

项目共享配置：

.mcp.json（项目根）
结构同 mcpServers，通常包含 type（http/stdio）、url 或 command

Codex CLI

配置文件（TOML）：

~/.codex/config.toml
.codex/config.toml（可信项目）

核心结构（[mcp_servers.<name>]）：

[mcp_servers.context7]
url = "<https://mcp.context7.com/mcp>"
http_headers = { CONTEXT7_API_KEY = "..." }

[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]

[mcp_servers.memory.env]
NODE_ENV = "production"

命令：

codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp --help

Gemini CLI

配置文件：

~/.gemini/settings.json
.gemini/settings.json

核心结构（mcpServers）：

本地进程：command/args/env
远端 HTTP：httpUrl
SSE：url

{
  "mcpServers": {
    "httpServer": {
      "httpUrl": "<https://api.example.com/mcp>",
      "headers": { "Authorization": "Bearer ..." }
    },
    "stdioServer": {
      "command": "python",
      "args": ["server.py"]
    }
  }
}

命令：

gemini mcp add --transport http my-http <https://api.example.com/mcp>
gemini mcp add my-stdio npx -y @modelcontextprotocol/server-memory
gemini mcp list

Kimi CLI

配置文件：

~/.kimi/mcp.json

核心结构：

与 Cursor 风格兼容（mcpServers + url/command/args/env）

命令：

kimi mcp add --transport http context7 <https://mcp.context7.com/mcp>
kimi mcp add --transport stdio memory -- npx -y @modelcontextprotocol/server-memory
kimi mcp list

OpenCode

配置文件：

~/.config/opencode/opencode.json
opencode.json（项目）

核心结构（mcp）：

type: "local" + command（数组）
type: "remote" + url
常用字段：enabled、environment、headers

{
  "$schema": "<https://opencode.ai/config.json>",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "<https://mcp.context7.com/mcp>",
      "enabled": true
    }
  }
}

官方命令入口：

opencode mcp add
opencode mcp list
opencode mcp auth [name]
opencode mcp debug <name>

Kilo

配置文件：

~/.config/kilo/kilo.json
~/.config/kilo/kilo.jsonc
kilo.json
.kilo/kilo.json

核心结构（mcp）：

type: "remote" + url
type: "local" + command（数组）
常用字段：enabled、headers、environment、timeout

{
  "$schema": "<https://kilo.ai/config.json>",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "<https://mcp.context7.com/mcp>",
      "enabled": true
    }
  }
}

官方命令入口：

kilo mcp add
kilo mcp list
kilo mcp auth

Factory Droid

配置文件：

~/.factory/mcp.json
.factory/mcp.json

核心结构（mcpServers）：

type: "http" + url
type: "stdio" + command/args
常用字段：headers、env、disabled

命令：

droid mcp add linear <https://mcp.linear.app/mcp> --type http
droid mcp add memory "npx -y @modelcontextprotocol/server-memory"
droid mcp remove linear

Goose

Goose 更偏“扩展管理”，MCP 常通过交互配置：

goose configure

配置文件：

~/.config/goose/config.yaml

对应关系：

远端 MCP -> Remote Extension (Streamable HTTP)
本地 MCP -> Command-line Extension

临时启用也可以直接从命令行开会话：

goose session --with-extension "uvx mcp-server-fetch"
goose session --with-streamable-http-extension "<https://example.com/mcp>"

Crush

配置文件：

.crush.json
crush.json
~/.config/crush/crush.json

核心结构（mcp）：

远端 HTTP: type: "http" + url
SSE: type: "sse" + url
本地进程: type: "stdio" + command/args
常用字段：headers、env、timeout、disabled、disabled_tools

{
  "$schema": "<https://charm.land/crush.json>",
  "mcp": {
    "context7": {
      "type": "http",
      "url": "<https://mcp.context7.com/mcp>",
      "headers": { "Authorization": "Bearer ..." }
    },
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

说明：

crush 目前没有官方的 mcp add 子命令