はじめに
Claude Code などのAIコーディングアシスタントは、MCP(Model Context Protocol)というプロトコルを通じてカスタムツールを追加できます。
「自作ツールを繋げる」と聞くと難しそうですが、公式のC# SDKを使うと驚くほどシンプルに実装できます。今回は天気取得ツールを例に、ゼロからMCPサーバーを作ってClaude Codeに接続するまでを試してみました。
2026年11月に直しました:最初は「Claude Code の
settings.jsonに書いて登録する」と書いていましたが、誤りでした。今の Claude Code ではclaude mcp addで登録します。.NET 10 と Claude Code 2.1.322 で、手順を最初からやり直して確かめました。直した箇所は「2026年11月に直したこと」にまとめています。
MCPとは?
MCP(Model Context Protocol)はAnthropicが2024年に公開したオープンプロトコルです。AIと外部ツール・データソースが標準インターフェースで通信できるようにする仕組みです。
Claude Code ←→ MCPプロトコル ←→ 自作MCPサーバー ←→ 外部API・DBなど
MCPサーバーを自作することで「社内APIを叩くツール」「プロジェクト固有の操作」などをAIに追加できます。
用意するもの
- .NET 10 SDK(10.0.403 で確かめました)
- Claude Code(2.1.322 で確かめました)
プロジェクト作成
コンソールアプリとして作成します。
dotnet new console -n WeatherMcp
cd WeatherMcp
NuGetパッケージを追加します。
dotnet add package ModelContextProtocol
dotnet add package Microsoft.Extensions.Hosting
2026年11月の時点では、ModelContextProtocol 2.4.0 と Microsoft.Extensions.Hosting 11.0.0 が入りました。記事を書いた4月はプレビュー版だったので --prerelease を付けていましたが、今は正式版が出ているので要りません。
ModelContextProtocolとは?
Microsoftが管理するC#公式MCP SDK。Toolの定義を属性ベースで書けるため実装がシンプルです。
実装
Program.cs
Program.cs をまるごと以下に置き換えます。
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using ModelContextProtocol.Server;
var builder = Host.CreateApplicationBuilder(args);
// 標準出力は MCP のやり取りに使うので、ログは標準エラー出力に出す
builder.Logging.AddConsole(options => options.LogToStandardErrorThreshold = LogLevel.Trace);
builder.Services.AddMcpServer()
.WithStdioServerTransport()
.WithTools<WeatherTools>();
await builder.Build().RunAsync();
ログの行を足したのには理由があります。この行が無いと、起動のログ(info: Microsoft.Hosting.Lifetime[0] ...)が MCP の応答と同じ標準出力に混ざって出てきます。MCP の stdio のやり取りでは、標準出力には応答だけを出すのが決まりなので、ログは標準エラー出力に回しておきます。
WeatherTools.cs
プロジェクトに WeatherTools.cs を新規作成します。
using ModelContextProtocol.Server;
using System.ComponentModel;
[McpServerToolType]
public class WeatherTools
{
private static readonly HttpClient _http = new();
[McpServerTool]
[Description("指定した都市の現在の天気(天候・気温・湿度)を取得します")]
public static async Task<string> GetWeather(
[Description("都市名(英語)例: Tokyo, Osaka, New York")] string city)
{
var url = $"https://wttr.in/{Uri.EscapeDataString(city)}?format=%C+%t+%h";
var result = await _http.GetStringAsync(url);
return $"{city}の天気: {result.Trim()}";
}
}
属性の役割は次のとおりです。
| 属性 | 役割 |
|---|---|
[McpServerToolType] | このクラスにToolが含まれることを宣言 |
[McpServerTool] | このメソッドをToolとして公開 |
[Description] | AIへの説明文。AIがToolの使い方を理解するために重要 |
天気データは wttr.in を使います。APIキー不要で使える便利なサービスです。フォーマット文字列の意味:
| 記号 | 内容 |
|---|---|
%C | 天候の説明(Sunny、Cloudy など) |
%t | 気温 |
%h | 湿度 |
単体動作確認
Claude Codeに繋ぐ前に単体で確認します。
dotnet run
起動したら標準入力に以下をペーストしてEnterを押します。
{ "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }
次のような応答が返ってきたら成功です(説明文の日本語は \u6307... のようにエスケープされて出ます。ここでは省いています)。
{"result":{"tools":[{"name":"get_weather","description":"…","inputSchema":{"type":"object","properties":{"city":{"description":"…","type":"string"}},"required":["city"]}}]},"id":1,"jsonrpc":"2.0"}
ツールの名前は、メソッド名の GetWeather ではなく get_weather になります。SDK が名前を小文字とアンダースコアの形に直すためです。Ctrl+C で終了します。
Claude Codeに登録する
プロジェクトのフォルダとは別の、Claude Code を使うフォルダで次を実行します。
claude mcp add weather -- dotnet run --project C:/path/to/WeatherMcp
C:/path/to/WeatherMcp は実際のパスに変えてください。-- から後ろが、MCP サーバーを起動するコマンドです。
Added stdio MCP server weather with command: dotnet run --project C:/path/to/WeatherMcp to local config
claude mcp list で、つながるかどうかを確かめられます。
weather: dotnet run --project C:/path/to/WeatherMcp - ✔ Connected
登録する範囲は --scope で選べます。
--scope | 登録される範囲 | 書き込まれる場所 |
|---|---|---|
local(省略時) | 自分だけ、このフォルダだけ | ~/.claude.json |
project | このフォルダを使う全員(リポジトリに入れられる) | フォルダの .mcp.json |
user | 自分だけ、すべてのフォルダ | ~/.claude.json |
--scope project にすると、フォルダに次の .mcp.json ができます。
{
"mcpServers": {
"weather": {
"type": "stdio",
"command": "dotnet",
"args": [
"run",
"--project",
"C:/path/to/WeatherMcp"
],
"env": {}
}
}
}
登録を消すときは claude mcp remove weather です。
起動を速くするには
dotnet runは毎回ビルドが走るため起動が遅めです。dotnet publishでexeを生成して直接指定するのがおすすめです。dotnet publish -c Release -r win-x64 --self-containedclaude mcp add weather -- C:/path/to/WeatherMcp/bin/Release/net10.0/win-x64/publish/WeatherMcp.exe
実際に使ってみる
登録したフォルダで Claude Code を起動すると、weather サーバーにつながります。そのまま話しかけると:
> get_weather ツールで Tokyo と Osaka の天気を取得して、比較を1〜2文で答えて
Claude Code が get_weather を2回呼び出し、wttr.in から取得した結果をまとめて返してくれます。2026年11月12日に試したときの答えは、次のとおりでした。
東京は局地的に雨がぱらつく天気で気温19°C・湿度62%、大阪は曇りで気温18°C・湿度61%です。気温と湿度はほぼ同じで、違いは東京が雨の可能性ありという点だけです。
ツール呼び出しの様子が見えるのが面白いところです。初めて呼ぶときは、ツールを使ってよいかを Claude Code が聞いてきます。
2026年11月に直したこと
記事を書いてから半年たって、手順を最初からやり直しました。直したのは次の点です。
- 登録の方法を、
settings.jsonのmcpServersに書く方法からclaude mcp addに直しました。最初の書き方は誤りでした - .NET 9 から .NET 10 にしました。publish した exe の場所も
net10.0になります ModelContextProtocolの正式版が出たので、--prereleaseを外しました- ログを標準エラー出力に回す行を
Program.csに足しました - 応答に出るツールの名前は
get_weatherでした - 使ってみた結果を、実際に Claude Code から呼び出した答えに差し替えました
この記事のあと、自分で MCP サーバーを作ったことはまだありません。ふだん使っている MCP は、claude.ai から Slack などにつなぐものです。自分で作るより、用意されているものをつなぐほうが多いのが今の使い方です。それでも、社内の API のように、用意されたものが無い相手につなぎたくなったときは、この手順で作れるとわかっているのは心強いです。
まとめ
- C#の公式SDKを使えば、属性を付けたメソッドがそのままClaude Codeのツールになります。書いたのは2つのファイルだけでした
- 登録は
settings.jsonではなくclaude mcp addです。標準出力はMCPの応答専用なので、ログは標準エラー出力に回します - 天気APIの代わりに社内REST APIやSQLクエリを呼ぶToolに差し替えれば、実務でも十分使えそうです
関連記事
[Released] dev-orchestra: 設計の前のインタビューと、レビューの手間を減らす機能を追加 v1.4.0
dev-orchestra v1.4.0 の変更をまとめました。設計の前に 1 問ずつ聞くインタビュー(design.ask_questions: grill)が入りました。レビューでは、決めたことをレビュアーに伝え、元からあった軽い問題を仕分けから外し、再レビューの人数を減らします。軽い段の自動選択や、新しいセッションでの続きも入りました。
dev-orchestra に、設計の前にインタビューさせてみた
dev-orchestra 1.4.0 で入った design.ask_questions: grill を、16 本目と同じ「タスクに期限を付けて」という依頼で試しました。質問は 1 つずつ、全部で 8 問。条件を足した答えには追加の質問が来ましたが、あいまいな答えは掘り下げずに解釈して進み、資料にある「意図」や「成功をどう判断するか」は聞かれませんでした。
dev-orchestra に、設計の前に質問させてみた
dev-orchestra 1.3.0 の「設計の前の質問」(design.ask_questions)を、あいまいな依頼とはっきりした依頼で試しました。auto ではあいまいな依頼にだけ質問が来て、true では「はっきりしている」と思った依頼にもアーキテクトが4つ質問しました。人が見ている実行では、答えるまで計画は書かれません。