git clone <repository-url>
cd minimal-mcp-server
npm install

npm run build

npm start

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "minimal-mcp-server": {
      "command": "node",
      "args": ["/path/to/minimal-mcp-server/build/index.js"]
    }
  }
}

tail -f ~/Library/Logs/Claude/mcp-server-minimal-mcp-server.log

「Hello World」とエコーして

今何時？

東京タワーについて教えて
富士山のWikipedia情報を調べて

minimal-mcp-server/
├── src/
│   └── index.ts          # サーバー本体（ツール定義含む）
├── build/                 # コンパイル出力（git管理外）
├── package.json
└── tsconfig.json

server.registerTool(
  "tool-name",             // ツール名（ケバブケース推奨）
  {
    description: "ツールの説明（Claudeがツール選択の判断に使う）",
    inputSchema: {         // 引数定義（Zodスキーマ）省略可
      param1: z.string().describe("引数の説明"),
      param2: z.number().describe("引数の説明"),
    },
  },
  async ({ param1, param2 }) => {
    // ツールの処理
    return {
      content: [
        { type: "text", text: "結果のテキスト" },
      ],
    };
  },
);

server.registerTool(
  "search-wikipedia",
  {
    description: "日本語Wikipediaでキーワードを検索し、記事の要約を返すツール",
    inputSchema: {
      query: z.string().describe("検索キーワード（例: 東京タワー）"),
    },
  },
  async ({ query }) => {
    const url = `https://ja.wikipedia.org/api/rest_v1/page/summary/${encodeURIComponent(query)}`;
    const res = await fetch(url);
    if (!res.ok) {
      return {
        content: [
          { type: "text", text: `「${query}」に該当する記事が見つかりませんでした。` },
        ],
      };
    }
    const data = await res.json();
    return {
      content: [
        {
          type: "text",
          text: `【${data.title}】\n${data.extract}\n\nURL: ${data.content_urls?.desktop?.page ?? "N/A"}`,
        },
      ],
    };
  },
);

Claude Desktop → stdin → StdioServerTransport → McpServer → ツール実行
                                                                 ↓
Claude Desktop ← stdout ← StdioServerTransport ← McpServer ← 結果返却