{
  "name": "send_email",
  "description": "发送一封电子邮件到指定地址",
  "inputSchema": {
    "type": "object",
    "properties": {
      "to": { "type": "string", "description": "收件人邮箱" },
      "subject": { "type": "string", "description": "邮件主题" },
      "body": { "type": "string", "description": "邮件正文" }
    },
    "required": ["to", "subject", "body"]
  }
}

{
  "resources": [
    {
      "uri": "file:///project/README.md",
      "name": "项目说明文档",
      "mimeType": "text/markdown"
    },
    {
      "uri": "db://users/recent",
      "name": "最近注册的用户",
      "mimeType": "application/json"
    }
  ]
}

// ① 客户端发送请求：列出所有工具
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

// ② 服务器返回响应
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "description": "获取指定城市天气",
        "inputSchema": { ... }
      }
    ]
  }
}

// 步骤 1: 客户端 → 服务器
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {
      "sampling": {}
    },
    "clientInfo": {
      "name": "my-ai-app",
      "version": "1.0.0"
    }
  }
}

// 步骤 2: 服务器 → 客户端
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "protocolVersion": "2025-11-25",
    "capabilities": {
      "tools": {},
      "resources": { "subscribe": true }
    },
    "serverInfo": {
      "name": "weather-server",
      "version": "2.1.0"
    }
  }
}

// 步骤 3: 客户端 → 服务器 (通知，无 id)
{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

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

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// 创建 MCP 服务器实例
const server = new McpServer({
  name: "weather-server",
  version: "1.0.0",
});

// 注册一个工具：获取天气
server.tool(
  "get_weather",                     // 工具名称
  "获取指定城市的当前天气信息",          // 描述
  {                                       // 参数 schema (Zod)
    city: z.string().describe("城市名称"),
  },
  async ({ city }) => {                  // 处理函数
    // 这里可以调用真实的天气 API
    const weatherData = {
      city,
      temperature: "22°C",
      condition: "晴朗",
      humidity: "45%",
    };

    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(weatherData, null, 2),
        },
      ],
    };
  }
);

// 注册一个资源：服务器状态
server.resource(
  "status",
  "server://status",
  async () => ({
    contents: [{
      uri: "server://status",
      text: "服务器运行正常，已注册 1 个工具",
      mimeType: "text/plain",
    }],
  })
);

// 启动服务器，使用 stdio 传输
const transport = new StdioServerTransport();
await server.connect(transport);

pip install mcp

from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent
import json

# 创建服务器实例
app = Server("weather-server")

# 列出可用工具
@app.list_tools()
async def list_tools():
    return [
        Tool(
            name="get_weather",
            description="获取指定城市的当前天气",
            inputSchema={
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "城市名称"
                    }
                },
                "required": ["city"]
            }
        )
    ]

# 处理工具调用
@app.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "get_weather":
        city = arguments["city"]
        # 模拟天气数据（实际可调用 API）
        data = {
            "city": city,
            "temperature": "22°C",
            "condition": "晴朗",
        }
        return [TextContent(
            type="text",
            text=json.dumps(data, ensure_ascii=False)
        )]

# 启动服务器
async def main():
    async with stdio_server() as (read, write):
        await app.run(
            read, write,
            app.create_initialization_options()
        )

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["path/to/server.js"]
    }
  }
}

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from
  "@modelcontextprotocol/sdk/client/stdio.js";

// ① 创建传输层：启动服务器进程
const transport = new StdioClientTransport({
  command: "node",
  args: ["./server.js"],
});

// ② 创建客户端并连接
const client = new Client({
  name: "my-client",
  version: "1.0.0",
});
await client.connect(transport);

// ③ 发现服务器提供的工具
const { tools } = await client.listTools();
console.log("可用工具：", tools.map(t => t.name));

// ④ 调用工具
const result = await client.callTool({
  name: "get_weather",
  arguments: { city: "北京" },
});
console.log("天气结果：", result.content);

// ⑤ 读取资源
const resource = await client.readResource({
  uri: "server://status",
});
console.log("状态：", resource.contents);

// ⑥ 断开连接
await client.close();