なぜ exe にするか

Node.js 版は、渡す相手にも Node.js が要ります。それが難しい場面があります。

.NET Framework 4.x は Windows 10・11 に最初から入っています。そのコンパイラ（csc.exe）も同梱されているので、追加で何も入れずに exe を作れます。

書く

全文は samples/A3-csharp/Server.cs にあります。要点だけ見ます。

文字コードを間違えない

// BOM を付けない UTF-8 にする。BOM を出すと相手が JSON として読めない
var utf8 = new UTF8Encoding(false);
var input = new StreamReader(Console.OpenStandardInput(), utf8);
_out = new StreamWriter(Console.OpenStandardOutput(), utf8);
_out.AutoFlush = true;

AutoFlush = true も要ります。付けないと応答が溜まったまま送られず、相手は待ち続けます。

JSON を扱う

.NET Framework には JavaScriptSerializer が入っています。参照を 1 つ足すだけで使えます。

using System.Web.Script.Serialization;

static readonly JavaScriptSerializer Json = new JavaScriptSerializer();

// 読む: Dictionary<string, object> になる
var request = (Dictionary<string, object>)Json.DeserializeObject(line);

// 書く
_out.Write(Json.Serialize(message));

受け取って返す

string line;
while ((line = input.ReadLine()) != null)
{
	if (line.Trim().Length == 0) continue;
	Log("受信: " + line);

	Dictionary<string, object> request;
	try
	{
		request = (Dictionary<string, object>)Json.DeserializeObject(line);
	}
	catch
	{
		Log("JSON として読めなかった行を捨てた");
		continue;
	}

	// id が無いものは通知。応答してはいけない
	if (!request.ContainsKey("id"))
	{
		Log("通知: " + Get(request, "method"));
		continue;
	}

	Handle(request);
}

ログは stderr へ出します。Node 版と同じ約束です。

// stdout は JSON-RPC 専用。ログは stderr へ出す
static void Log(string message)
{
	Console.Error.WriteLine("[csharp] " + message);
}

ビルドする

"%WINDIR%\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /nologo /optimize /utf8output ^
	/out:mcp-server.exe /r:System.Web.Extensions.dll Server.cs

ダブルクリックで作れるよう build.cmd を置いてあります。64 ビット版が無ければ 32 ビット版を探すようにしています。

set CSC=%WINDIR%\Microsoft.NET\Framework64\v4.0.30319\csc.exe
if not exist "%CSC%" set CSC=%WINDIR%\Microsoft.NET\Framework\v4.0.30319\csc.exe
if not exist "%CSC%" (
	echo csc.exe が見つかりません。.NET Framework 4.x が入っているか確認してください
	pause
	exit /b 1
)

実行するとこうなります。

できた: mcp-server.exe (7,680 バイト)

動かす

@(
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"手","version":"1.0"}}}'
'{"jsonrpc":"2.0","method":"notifications/initialized"}'
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
'{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"add","arguments":{"a":2,"b":3}}}'
) -join "`n" | ./mcp-server.exe

実際の出力です。

[csharp] 起動した
[csharp] 受信: {"jsonrpc":"2.0","id":1,"method":"initialize",...}
{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-11-25","capabilities":{"tools":{}},"serverInfo":{"name":"csharp","version":"1.0.0"}}}
[csharp] 受信: {"jsonrpc":"2.0","method":"notifications/initialized"}
[csharp] 通知: notifications/initialized
[csharp] 受信: {"jsonrpc":"2.0","id":2,"method":"tools/list"}
{"jsonrpc":"2.0","id":2,"result":{"tools":[{"name":"add","description":"2 つの数を足す",...}]}}
[csharp] 受信: {"jsonrpc":"2.0","id":3,"method":"tools/call",...}
{"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"5"}]}}

登録する

claude mcp add csharp -- docs/samples/A3-csharp/mcp-server.exe

コマンドが exe になるだけで、あとは Node 版と同じです。

テストも同じ道具で書ける

クライアント側は Node のままでよいので、Node 版と同じテストの仕組みが使えます。

test('C# 版でも日本語が壊れない', { skip }, async () => {
	const client = await connect(EXE, { command: EXE });

	try {
		// BOM を付けずに UTF-8 で書き出しているかの確認でもある
		const { tools } = await client.listTools();
		assert.equal(tools[0].description, '2 つの数を足す');

		const result = await client.callTool({ name: 'add', arguments: { a: 'あ', b: 3 } });
		assert.equal(result.isError, true);
		assert.match(textOf(result), /数値を渡してください/);
	} finally {
		await client.close();
	}
});

✔ C# 版でもツールの一覧と実行が通る (128.4249ms)
✔ C# 版でも日本語が壊れない (104.3658ms)
✔ C# 版でも小数を扱える (101.7517ms)

Node 版との違い

選び方