MCPツールを開発する

flowchart LR
    A["1. ユースケースを定義する"]
    B["2. ツールの粒度・入出力を設計する"]
    C["3. 実装する<br/>（スキャフォルド + 手動実装）"]
    D["4. ローカルでテストする"]
    E["5. Claude Codeに接続して確認する"]
 
    A --> B --> C --> D --> E
 
    style A fill:#e8f4fd,stroke:#1a73e8
    style E fill:#fff3e0,stroke:#e65100

# 良くない例: 内部実装をそのまま公開してしまっている
calculate_multiply(a, b)
calculate_add(a, b)
 
# 良い例: 業務上の意味のあるまとまりで公開している
calculate_price_with_tax(price, taxRate)
calculate_discounted_price(price, discountPercent)

// server.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
 
const server = new McpServer({
  name: "pricing-tools",
  version: "1.0.0",
});
 
// ツール1: 税込価格を計算する
server.registerTool(
  "calculate_price_with_tax",
  {
    title: "税込価格を計算する",
    description:
      "税抜価格と税率から税込価格を計算します。小数点以下は切り捨てます。",
    inputSchema: {
      price: z.number().int().positive().describe("税抜価格（円、整数）"),
      taxRate: z
        .number()
        .min(0)
        .max(1)
        .default(0.1)
        .describe("税率（例: 10%なら0.1）"),
    },
  },
  async ({ price, taxRate }) => {
    // 入力値の妥当性は schema である程度担保されるが、
    // ビジネスロジック上の異常値（極端な税率など）はここで追加チェックする
    if (taxRate > 0.5) {
      return {
        content: [
          {
            type: "text",
            text: `エラー: 税率が異常です（${taxRate}）。0〜0.5の範囲で指定してください。`,
          },
        ],
        isError: true,
      };
    }
 
    const taxedPrice = Math.floor(price * (1 + taxRate));
    return {
      content: [
        {
          type: "text",
          text: `税込価格: ${taxedPrice}円（税抜${price}円、税率${taxRate * 100}%）`,
        },
      ],
    };
  }
);
 
// ツール2: 割引後価格を計算する
server.registerTool(
  "calculate_discounted_price",
  {
    title: "割引後価格を計算する",
    description: "価格と割引率から割引後の価格を計算します。",
    inputSchema: {
      price: z.number().int().positive().describe("割引前価格（円、整数）"),
      discountPercent: z
        .number()
        .min(0)
        .max(100)
        .describe("割引率（%）。例: 20なら20%オフ"),
    },
  },
  async ({ price, discountPercent }) => {
    const discounted = Math.floor(price * (1 - discountPercent / 100));
    return {
      content: [
        {
          type: "text",
          text: `割引後価格: ${discounted}円（元価格${price}円、${discountPercent}%オフ）`,
        },
      ],
    };
  }
);
 
const transport = new StdioServerTransport();
await server.connect(transport);

async ({ price, taxRate }) => {
  try {
    // 外部APIを呼ぶ処理などをここに書く
    const result = await fetchExternalRate();
    return {
      content: [{ type: "text", text: `結果: ${result}` }],
    };
  } catch (error) {
    // 例外を握りつぶさず、isErrorで明示的に失敗を伝える
    return {
      content: [
        {
          type: "text",
          text: `外部レート取得に失敗しました: ${
            error instanceof Error ? error.message : String(error)
          }`,
        },
      ],
      isError: true,
    };
  }
};

npx @modelcontextprotocol/inspector node server.ts

// pricing.test.ts
import { describe, it, expect } from "vitest";
import { calculatePriceWithTax } from "./pricing";
 
describe("calculatePriceWithTax", () => {
  it("税率10%のとき、税抜1000円が税込1100円になる", () => {
    expect(calculatePriceWithTax(1000, 0.1)).toBe(1100);
  });
 
  it("小数点以下が出る場合、切り捨てられる", () => {
    expect(calculatePriceWithTax(999, 0.1)).toBe(1098); // 1098.9 → 1098
  });
 
  it("税率が0.5を超える異常値の場合、エラーになる", () => {
    expect(() => calculatePriceWithTax(1000, 0.8)).toThrow();
  });
});