Claude Code MCP 集成指南：通过 Model Context Protocol 连接外部工具

# 添加 stdio 类型的 MCP 服务器
claude mcp add <server-name> --transport stdio -- <command> [args...]

# 示例：添加文件系统 MCP 服务器
claude mcp add filesystem --transport stdio -- npx -y @modelcontextprotocol/server-filesystem /path/to/files

# 添加带环境变量的 MCP 服务器
claude mcp add github --transport stdio --env GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github

# 添加 HTTP 类型的 MCP 服务器（远程）
claude mcp add my-api --transport http https://api.example.com/mcp

# 添加 SSE 类型的 MCP 服务器
claude mcp add my-service --transport sse https://service.example.com/mcp

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"],
      "type": "stdio"
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      },
      "type": "stdio"
    }
  }
}

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_URL": "postgresql://localhost:5432/mydb"
      },
      "type": "stdio"
    }
  }
}

# 列出所有 MCP 服务器
claude mcp list

# 查看服务器详情
claude mcp get <server-name>

# 删除 MCP 服务器
claude mcp remove <server-name>

claude mcp add filesystem --transport stdio -- npx -y @modelcontextprotocol/server-filesystem /allowed/path

claude mcp add github --transport stdio --env GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github

claude mcp add postgres --transport stdio --env POSTGRES_URL=postgres://localhost/mydb -- npx -y @modelcontextprotocol/server-postgres

claude mcp add brave-search --transport stdio --env BRAVE_API_KEY=your_key -- npx -y @modelcontextprotocol/server-brave-search

claude mcp add puppeteer --transport stdio -- npx -y @modelcontextprotocol/server-puppeteer

claude mcp add slack --transport stdio --env SLACK_BOT_TOKEN=xoxb-your_token SLACK_TEAM_ID=T_id -- npx -y @modelcontextprotocol/server-slack

# 使用 GitHub MCP 查找 PR
find all open PRs related to authentication in the main repository

# 使用数据库 MCP 查询
show me the most active users from the users table in the last 7 days

# 使用文件系统 MCP 访问项目外文件
read the nginx config at /etc/nginx/nginx.conf and suggest optimizations

/mcp

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';

const server = new Server(
  { name: 'my-custom-server', version: '1.0.0' },
  { capabilities: { tools: {} } }
);

// 定义工具
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [{
    name: 'get_project_status',
    description: '获取项目的当前状态和统计',
    inputSchema: {
      type: 'object',
      properties: {
        project: { type: 'string', description: '项目名称' }
      },
      required: ['project']
    }
  }]
}));

// 处理工具调用
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === 'get_project_status') {
    const { project } = request.params.arguments;
    // 实现你的逻辑
    return {
      content: [{ type: 'text', text: `项目 ${project} 状态：正常运行` }]
    };
  }
  throw new Error(`Unknown tool: ${request.params.name}`);
});

// 启动服务器
const transport = new StdioServerTransport();
await server.connect(transport);

claude mcp add my-server --transport stdio -- node /path/to/my-server.js

# HTTP（推荐，支持 StreamableHTTP）
claude mcp add remote-service --transport http https://mcp.company.com/api

# SSE（旧格式，仍受支持）
claude mcp add legacy-service --transport sse https://mcp.company.com/sse