MCP Host 集成实战：让 Claude Desktop 用你的工具

什么是 MCP Host

MCP（Model Context Protocol）Host 是能调用 MCP Server 的 AI 客户端。Claude Desktop、Cursor、Continue 都已支持。

本教程带你写一个 MCP Server，然后把它接入 Claude Desktop。

步骤 1：创建 MCP Server

mkdir my-mcp-server && cd my-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk

创建 index.js：

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

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

server.setRequestHandler('tools/list', async () => ({
  tools: [{
    name: 'get_weather',
    description: '获取指定城市的当前天气',
    inputSchema: {
      type: 'object',
      properties: { city: { type: 'string', description: '城市名' } },
      required: ['city']
    }
  }]
}));

server.setRequestHandler('tools/call', async (request) => {
  if (request.params.name === 'get_weather') {
    const { city } = request.params.arguments;
    return { content: [{ type: 'text', text: city + '：晴，22°C' }] };
  }
});

const transport = new StdioServerTransport();
await server.connect(transport);

步骤 2：配置 Claude Desktop

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

{
  "mcpServers": {
    "my-tools": {
      "command": "node",
      "args": ["/absolute/path/to/my-mcp-server/index.js"]
    }
  }
}

步骤 3：重启并测试

1. 完全退出 Claude Desktop
2. 重新打开
3. 在对话中点击工具图标，确认 get_weather 出现
4. 试试问："北京今天天气怎么样？"

调试技巧

• Claude Desktop 开发者菜单中查看 MCP 日志
• Server 端用 console.error 输出调试信息
• 确认 Node.js 路径用绝对路径

常见问题

Server 不出现

• 检查 JSON 配置语法
• 确认 Node.js 可执行文件路径正确

工具调用超时

• 确认 Server 没有阻塞
• 工具函数应在 30 秒内返回