用意する

入れるもの

npm init -y
npm install @modelcontextprotocol/sdk

zod は SDK が依存しているので一緒に入りますが、自分のコードから直接使うので明示しておきます。

{
	"dependencies": {
		"@modelcontextprotocol/sdk": "^1.30.0",
		"zod": "^4.5.4"
	}
}

この資料を書いた時点の版

20 行で同じものになる

samples/03-sdk/server.mjs の全文です。02 章の 90 行と同じことをします。

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: 'sdk',
	version: '1.0.0',
});

server.registerTool(
	'add',
	{
		title: '足し算',
		description: '2 つの数を足す',
		// 入力の形は zod で書く。JSON Schema には SDK が変換して送る
		inputSchema: {
			a: z.number().describe('1 つめの数'),
			b: z.number().describe('2 つめの数'),
		},
	},
	async ({ a, b }) => ({
		content: [{ type: 'text', text: String(a + b) }],
	}),
);

// stdio に繋ぐ。ここで初めて標準入出力を読み書きし始める
await server.connect(new StdioServerTransport());

02 章と同じ手順で動かせます。

{"result":{"protocolVersion":"2025-11-25","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"sdk","version":"1.0.0"}},"jsonrpc":"2.0","id":1}
{"result":{"content":[{"type":"text","text":"5"}]},"jsonrpc":"2.0","id":3}

何が省けたか

入力の形は zod で書く

inputSchema には zod の定義を渡します。SDK がこれを JSON Schema に変換してホストへ送ります。

inputSchema: {
	a: z.number().describe('1 つめの数'),
	b: z.number().describe('2 つめの数'),
}

実際に送られる JSON Schema です。

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "a": { "type": "number", "description": "1 つめの数" },
    "b": { "type": "number", "description": "2 つめの数" }
  },
  "required": ["a", "b"]
}

よく使う書き方

SDK が黙って足すもの

tools/list の応答を実際に見ると、書いた覚えのない項目が入っています。

{
  "name": "add",
  "title": "足し算",
  "description": "2 つの数を足す",
  "inputSchema": { ... },
  "execution": { "taskSupport": "forbidden" }
}

execution.taskSupport は SDK が付けたものです。「このツールはタスクとして実行できない」という意味で、09. タスク で扱います。今は気にしなくて構いませんが、覚えのない項目が出ても壊れてはいない、と知っておくと安心です。

capabilities も自動で付く

registerTool を呼べば tools、registerResource を呼べば resources が capabilities に足されます。02 章で手書きしていた申告は要りません。

"capabilities": { "tools": { "listChanged": true } }

次の章へ

サーバーは書けました。次はこれを Claude Code・Codex・Antigravity に登録して、実際に呼ばせます。3 つとも登録の仕方が違います。