本文へスキップ
Kitbay

MCPサーバーの作り方

Kitbay編集部 ·

MCPサーバーを作るには、公式のMCP SDKを1つ選び、サーバーが提供するツール(必要に応じてリソースとプロンプトも)を定義し、ローカルで使うならstdio、リモートで使うならStreamable HTTPで動かします。AIクライアントに接続する前に、MCP Inspectorでテストしましょう。シンプルなツールサーバーなら、コードは数十行で済みます。

このガイドは公式のMCPドキュメントに沿って進めます。ドキュメントのチュートリアルでは、小さな天気予報サーバーを作ります。用語になじみがない場合は、まずMCPサーバーとはを読んでください。

ステップ1:SDKを選ぶ

MCPプロジェクトは公式SDKをメンテナンスしており、機能の充実度とメンテナンス状況に応じてランク分けしています。

ランク 言語
Tier 1 TypeScript、Python、C#、Go、Rust、Ruby
Tier 2 Java
Tier 3 Swift、PHP、Kotlin

どのSDKでもツール、リソース、プロンプトを公開でき、ローカルとリモートの両方のトランスポートに対応しています。新しいプロトコルバージョンへの対応時期はSDKごとに異なるため、使うSDKがどのリビジョンに対応しているかを確認してください。現在の仕様のリビジョンは2026年7月28日付で、プロトコルがステートレスになりました。リクエストごとにバージョンと機能の情報を持たせる仕組みになっており、この処理はSDK側で行われます。

ステップ2:サーバーで何を提供するかを決める

MCPサーバーが提供する構成要素は3種類です。

構成要素 制御するのは 用途
ツール モデルが呼び出すタイミングを決める 操作やクエリ:Issueの作成、レコードの検索、ファイルの変換
リソース アプリケーションが何を含めるかを決める 読み取り専用のコンテキスト:ファイル、データベーススキーマ、APIドキュメント
プロンプト ユーザーが選ぶ 再利用できるテンプレート。スラッシュコマンドとして表示されることが多い

ほとんどのサーバーはツールから始めます。ツールごとに、わかりやすい名前、モデルがいつ使うべきかを伝える説明、入力スキーマを書きます。MCPのドキュメントでは、単なるcalculateではなくcalculator_arithmeticのような具体的な名前を勧めています。1つのツールでは1つの操作だけを行うようにし、どのツールが読み取りだけで、どのツールがデータを変更できるかを早めに決めておきましょう。ユーザーにとってもクライアントにとっても重要な情報だからです。

ステップ3:サーバーを書く

公式チュートリアルのPython版では、uv add "mcp[cli]"でSDKをインストールし、おおよそ次のようなコードを書きます。

from mcp.server import MCPServer

mcp = MCPServer("weather")

@mcp.tool()
async def get_forecast(latitude: float, longitude: float) -> str:
    """Get the weather forecast for a location.

    Args:
        latitude: Latitude of the location
        longitude: Longitude of the location
    """
    # call the weather service's API here and return readable text
    ...

if __name__ == "__main__":
    mcp.run(transport="stdio")

SDKは型ヒントとdocstringを読み取り、ツールの名前、説明、入力スキーマを作ります。TypeScriptのチュートリアルでは、@modelcontextprotocol/serverパッケージとスキーマ用のzodを使い、McpServerを作成してregisterToolでツールを追加します。ほかの言語ではそれぞれの言語の流儀に従います。チュートリアルにはJava、Kotlin、C#版もあります。

ログ:標準出力をきれいに保つ

これは、始めたばかりのころに最もよくある失敗です。stdioでは、クライアントとサーバーが標準出力を通じてJSON-RPCメッセージをやり取りするため、そこに余計なテキストを出力すると接続が壊れます。Pythonではprint()を、Nodeではconsole.log()を避けてください。代わりに、Pythonのloggingモジュールやconsole.error()などを使って、ログを標準エラー出力に書き出します。

ステップ4:トランスポートを選ぶ

仕様では、2つの標準トランスポートが定義されています。

  • stdio。 クライアントがサーバーをサブプロセスとして起動し、その標準入出力を通じて改行区切りのメッセージをやり取りします。ユーザーのコンピューター上で動くサーバーに使います。MCPのセキュリティガイダンスでは、起動したクライアントだけがアクセスできるように制限できるため、ローカルサーバーにはstdioを勧めています。
  • Streamable HTTP。 サーバーは独立したプロセスとして動き、https://example.com/mcpのような1つのエンドポイントでPOSTリクエストを受け付けます。各レスポンスは、JSONオブジェクトか短いServer-Sent Eventsのストリームです。多くのユーザーがURLで接続する、ホスト型のサーバーに使います。

2024年の旧来のHTTP+SSEトランスポートは非推奨です。新しいサーバーでは使わないでください。

Streamable HTTPを選ぶ場合、仕様ではセキュリティ要件が定められています。DNSリバインディングを防ぐためにすべてのリクエストでOriginヘッダーを検証すること、ローカルで動かすときはすべてのインターフェースではなく127.0.0.1にバインドすること、接続を認証することです。MCPのドキュメントではトークンの取得にOAuthを勧めており、サーバーは自分宛てに発行されたものではないトークンを拒否しなければなりません。

ステップ5:MCP Inspectorでテストする

MCP Inspectorは、サーバーをテストするためのMCPプロジェクトのリファレンスツールです。Node 22.19.0以降が必要で、インストールせずにnpxで実行できます。

# browser interface, connected to a local stdio server
npx @modelcontextprotocol/inspector uv --directory /path/to/weather run weather.py

# scriptable command line: list tools and exit
npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

# a remote server
npx @modelcontextprotocol/inspector --server-url https://example.com/mcp --transport http

Webインターフェース、スクリプトやCI向けのCLI、ターミナルインターフェース(--tui)の3つのモードがあります。各ツールが正しいスキーマで表示されるか、呼び出しで期待どおりの結果が返るか、エラーがわかりやすいかを確認しましょう。なお、シークレットは、システムのキーチェーンがあればそこに保存されます。キーチェーンがない場合は、キーを設定しない限り暗号化されていないファイルに保存されます。

ステップ6:クライアントに接続する

ローカルサーバーの場合は、起動コマンドをクライアントに追加します。Claude Desktopでは、チュートリアルで次の内容をclaude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/weather", "run", "weather.py"]
    }
  }
}

パスは絶対パスで書き、クライアントがuvを見つけられない場合はフルパスを指定してください。Claude Codeで同じことをするには、claude mcp add --transport stdio weather -- uv --directory /ABSOLUTE/PATH/TO/weather run weather.pyを実行します。ほかのクライアントについては、MCPサーバーをAIクライアントに接続する方法を参照してください。

公開する前に

  • すべてのツールをドキュメントに書く。 どのツールが読み取りだけで、どのツールがデータを変更するのか、サーバーにどんな認証情報が必要なのかを明記します。
  • アクセス権は最小限にする。 APIのスコープは狭く絞り、何でもできる「フルアクセス」のトークンは避けます。
  • 入力は信頼できないものとして扱う。 ツールの引数は、悪意のあるコンテンツを読んだかもしれないモデルから渡されます。
  • インストールコマンドは省略せずに示す。 自分のマシンで何が実行されるのかを、ユーザーが正確に把握できるようにします。
  • ライセンスを選び、サーバーがメンテナンスされているかどうかも書いておきます。

安全上の注意

サーバーは実際のデータを操作します。開発中は、本番のシステムではなくテスト用のアカウントやサンプルファイルを対象にし、トークンの扱いやローカルサーバーについてのMCPプロジェクトのセキュリティガイダンスを読んでおいてください。慎重なユーザーが何を確認するかは、MCPのセキュリティに関するチェックポイントにまとめています。

関連情報

開発者向けのツールは、Kitbayのテストとデバッグのページにまとめています。既存のMCPサーバーを見て、ほかの開発者がツールをどうドキュメント化しているかを参考にすることもできます。システムに接続するよりも、エージェントに手順を教えることが主な目的なら、スキルのほうが合っているかもしれません。MCPとスキルの違いを参照してください。

よくある質問

MCPサーバーはどの言語で作ればよいですか?
公式SDKがある言語なら、どれでも作れます。MCPプロジェクトは、TypeScript、Python、C#、Go、Rust、RubyをTier 1、JavaをTier 2、Swift、PHP、KotlinをTier 3としています。
MCPサーバーはどうやってテストしますか?
MCPプロジェクト自身のテストツールであるMCP Inspectorを使います。npx @modelcontextprotocol/inspectorに続けてサーバーの起動コマンドを実行し、ブラウザ、ターミナル、CLIでツールの一覧表示や呼び出しを試せます。
デバッグ用のメッセージを出力すると、stdioのMCPサーバーが動かなくなるのはなぜですか?
stdioトランスポートでは標準出力でプロトコルのメッセージをやり取りするため、そこにほかの内容を出力するとメッセージが壊れます。ログは標準エラー出力に書き出してください。
MCPサーバーはオンラインでホストする必要がありますか?
いいえ。stdioを使うローカルサーバーはユーザーのコンピューター上で動き、AIクライアントが起動します。ユーザーにURLで接続してもらう場合だけ、Streamable HTTPでオンラインにホストしてください。

出典

ほかのガイド