AI工具连接协议

┌─────────────────────────────────────────────────────────┐
│                      MCP 架构图                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   ┌──────────────┐      MCP 协议       ┌──────────────┐ │
│   │   AI 应用     │ ◄────────────────► │  MCP 服务器   │ │
│   │  (Claude等)   │   (stdio/SSE)      │  (工具提供)   │ │
│   └──────────────┘                      └──────────────┘ │
│          │                                     │        │
│          │ 发现工具                             │ 实现工具 │
│          │ 调用工具                             │ 数据库   │
│          │ 获取资源                             │ API     │
│          │                                     │ 文件系统 │
│   ┌──────▼──────┐                      ┌──────▼──────┐ │
│   │   Prompt    │                      │   Tools     │ │
│   │   Resources │                      │   Resources │ │
│   └─────────────┘                      └─────────────┘ │
│                                                         │
└─────────────────────────────────────────────────────────┘

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "MCP tutorial"
    }
  }
}

# 安装官方创建工具
npm install -g @modelcontextprotocol/create-typescript-server

# 创建新项目
npx @modelcontextprotocol/create-typescript-server my-mcp-server

# 或使用 fastmcp 框架
npm install fastmcp

# 安装 Python SDK
pip install mcp

# 或使用官方 SDK
pip install modelcontextprotocol

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-mcp-server/dist/index.js"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

mkdir todo-mcp-server
cd todo-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node
npx tsc --init

// src/index.ts
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
  CallToolRequestSchema,
  ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
import { z } from "zod";

// 内存存储
const todos: Array<{
  id: string;
  task: string;
  priority: string;
  completed: boolean;
}> = [];

// 创建服务器
const server = new Server(
  { name: "todo-mcp-server", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

// 工具列表
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "add_todo",
      description: "添加一个新的待办事项",
      inputSchema: {
        type: "object",
        properties: {
          task: { type: "string", description: "待办事项内容" },
          priority: { type: "string", enum: ["low", "medium", "high"] },
        },
        required: ["task"],
      },
    },
    {
      name: "list_todos",
      description: "列出所有待办事项",
      inputSchema: { type: "object", properties: {} },
    },
  ],
}));

// 工具调用
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;
  
  if (name === "add_todo") {
    const todo = {
      id: Math.random().toString(36).substring(7),
      task: String(args.task),
      priority: String(args.priority || "medium"),
      completed: false,
    };
    todos.push(todo);
    return { content: [{ type: "text", text: `✅ 已添加：${todo.task}` }] };
  }
  
  if (name === "list_todos") {
    const list = todos.map(t => `○ ${t.task}`).join("\n");
    return { content: [{ type: "text", text: list || "暂无待办事项" }] };
  }
  
  throw new Error(`Unknown tool: ${name}`);
});

// 启动
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
}

main().catch(console.error);

server.setRequestHandler(ListResourcesRequestSchema, async () => ({
  resources: [
    {
      uri: "todos://stats",
      name: "待办统计",
      mimeType: "application/json",
    },
  ],
}));

server.setRequestHandler(ListPromptsRequestSchema, async () => ({
  prompts: [
    {
      name: "todo_summary",
      description: "生成待办事项摘要",
    },
  ],
}));

import { FastMCP } from "fastmcp";

const mcp = new FastMCP("My Server");

mcp.addTool("calculate", {
  parameters: z.object({ expression: z.string() }),
  async execute({ expression }) {
    return String(eval(expression));
  },
});

mcp.start();