What is MCP?

Node.js による MCP TypeScript サーバー

MCP とは？

Model Context Protocol (MCP) を使うと、LLM アプリケーションにデータや機能を安全かつ標準化された方法で公開するサーバーを構築できます。LLM とのやり取りに特化した Web API のようなものと考えてください。MCP サーバーでは、次のことができます。

• リソースを通じてデータを公開する（GET エンドポイントに似ており、LLM のコンテキストに情報を読み込むために使用されます）
• ツールを通じて機能を提供する（POST エンドポイントに似ており、コードの実行や、その他の副作用を伴う処理に使用されます）
• プロンプトを通じてやり取りのパターンを定義する（LLM とのやり取りに使える再利用可能なテンプレートです）
• そのほかにもさまざまなことができます！

リソース

リソースは、LLM にデータを公開するための仕組みです。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}`
    }]
  })
);

ツール

ツールを使うと、LLM がサーバーを通じてアクションを実行できます。リソースとは異なり、ツールは計算を実行し、副作用を発生させることが想定されています。

// 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 }]
    };
  }
);

プロンプト

プロンプトは、LLM がサーバーと効果的にやり取りするのに役立つ再利用可能なテンプレートです。

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

貢献

皆さまからの貢献をいつでも歓迎します！