npx @modelcontextprotocol/inspector node dist/index.js

npx @modelcontextprotocol/inspector --url https://my-server.example.com/mcp

npx @modelcontextprotocol/inspector --url https://my-server.example.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

import { describe, it, expect } from "vitest";

describe("search_products tool", () => {
  it("返回匹配的商品", async () => {
    const result = await searchProducts("跑步鞋", { limit: 5 });
    expect(result.results).toHaveLength(5);
    expect(result.results[0]).toHaveProperty("name");
    expect(result.results[0]).toHaveProperty("price");
  });

  it("空搜索返回空数组", async () => {
    const result = await searchProducts("不存在的商品xyz", { limit: 5 });
    expect(result.results).toHaveLength(0);
  });

  it("价格范围筛选有效", async () => {
    const result = await searchProducts("鞋", {
      minPrice: 500,
      maxPrice: 1000,
      limit: 10
    });
    result.results.forEach(p => {
      expect(p.price).toBeGreaterThanOrEqual(500);
      expect(p.price).toBeLessThanOrEqual(1000);
    });
  });
});

describe("get_order tool", () => {
  it("返回isError当订单不存在", async () => {
    const result = await getOrderTool({ orderId: "INVALID-001" });
    expect(result.isError).toBe(true);
    expect(result.content[0].text).toContain("不存在");
  });
});

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

describe("MCP Server集成测试", () => {
  let client: Client;

  beforeAll(async () => {
    const transport = new StdioClientTransport({
      command: "node",
      args: ["dist/index.js"]
    });
    client = new Client({
      name: "test-client",
      version: "1.0.0"
    });
    await client.connect(transport);
  });

  afterAll(async () => {
    await client.close();
  });

  it("初始化成功并返回Server信息", () => {
    const info = client.getServerInfo();
    expect(info.name).toBe("my-commerce-server");
  });

  it("工具列表非空", async () => {
    const tools = await client.listTools();
    expect(tools.tools.length).toBeGreaterThan(0);
  });

  it("工具执行返回正确格式", async () => {
    const result = await client.callTool("search_products", {
      query: "鞋"
    });
    expect(result.content[0].type).toBe("text");
    const data = JSON.parse(result.content[0].text);
    expect(data).toHaveProperty("results");
  });

  it("资源列表可获取", async () => {
    const resources = await client.listResources();
    expect(resources.resources.length).toBeGreaterThan(0);
  });

  it("资源可读取", async () => {
    const result = await client.readResource(
      "commerce://catalog/categories"
    );
    expect(result.contents[0].mimeType).toBe("application/json");
  });

  it("提示词可获取", async () => {
    const prompts = await client.listPrompts();
    expect(prompts.prompts.length).toBeGreaterThan(0);
  });
});

// 正确 — 输出到stderr
console.error("[INFO] Server started");
console.error(`[DEBUG] Processing request: ${method}`);

// 错误 — 会破坏协议通信
console.log("Server started");  // stdout是协议通道

// Server → Client 发送日志通知
server.sendLoggingMessage({
  level: "warning",
  logger: "inventory",
  data: "SKU SHOE-001 库存低于安全阈值"
});

curl -X POST https://my-server.example.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'