What is MCP?

使用 Node.js 构建 MCP TypeScript 服务

什么是 MCP？

Model Context Protocol (MCP) 可让你构建以安全、标准化的方式向大模型应用公开数据和功能的服务。你可以把它看作专为大模型交互设计的 Web API。MCP 服务可以：

• 通过资源公开数据（可以把它们看作 GET 端点；用于将信息加载到大模型的上下文中）
• 通过工具提供功能（可以把它们看作 POST 端点；用于执行代码或以其他方式产生副作用）
• 通过提示词定义交互模式（用于大模型交互的可复用模板）
• 以及更多！

资源

资源是向大模型公开数据的方式。它们类似于 REST API 中的 GET 端点——提供数据，但不应执行大量计算或产生副作用：

// Static resource
server.resource(
  "config",
  "config://app",
  async (uri) => ({
    contents: [{
      uri: uri.href,
      text: "App configuration here"
    }]
  })
);

// Dynamic resource with parameters
server.resource(
  "user-profile",
  new ResourceTemplate("users://{userId}/profile", { list: undefined }),
  async (uri, { userId }) => ({
    contents: [{
      uri: uri.href,
      text: `Profile data for user ${userId}`
    }]
  })
);

工具

工具让大模型能够通过你的服务执行操作。与资源不同，工具通常需要执行计算并产生副作用：

// Simple tool with parameters
server.tool(
  "calculate-bmi",
  {
    weightKg: z.number(),
    heightM: z.number()
  },
  async ({ weightKg, heightM }) => ({
    content: [{
      type: "text",
      text: String(weightKg / (heightM * heightM))
    }]
  })
);

// Async tool with external API call
server.tool(
  "fetch-weather",
  { city: z.string() },
  async ({ city }) => {
    const response = await fetch(`https://api.weather.com/${city}`);
    const data = await response.text();
    return {
      content: [{ type: "text", text: data }]
    };
  }
);

提示词

提示词是可复用的模板，可帮助大模型有效地与你的服务交互：

server.prompt(
  "review-code",
  { code: z.string() },
  ({ code }) => ({
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: `Please review this code:\n\n${code}`
      }
    }]
  })
);

贡献

欢迎随时贡献！