読み込み中

MCPでツールを定義する

レッスン 5210 分
読み込み中

公式のPython SDKを使用すると、MCPサーバーの構築がはるかにシンプルになります。複雑なJSONスキーマを手書きする代わりに、デコレータでツールを定義し、面倒な処理はSDKに任せることができます。

私たちのMCPサーバーのreadおよびupdateツールが、document.pdf、spreadsheet.xlsx、report.txt、spec.mdの4つのファイルに接続されている様子。

この例では、2つの中核ツールを持つドキュメント管理サーバーを作成します。1つはドキュメントを読み取るツール、もう1つはドキュメントを更新するツールです。すべてのドキュメントは、キーがドキュメントID、値がコンテンツであるシンプルな辞書として、メモリ上に存在します。

MCPサーバーのセットアップ

このプロジェクトではMCP Python SDKのバージョン1を使用しており、セットアップ時にそのバージョンがインストールされます。自分でプロジェクトをセットアップする場合は、"mcp[cli]<2" をインストールしてください。バージョン2では FastMCP が MCPServer に名称変更されているため、以下のインポートはバージョン2では失敗します。

Python MCP SDKを使うと、サーバーの作成が簡単になります。たった1行でサーバーを初期化できます。

python
from mcp.server.fastmcp import FastMCP
from pydantic import Field

mcp = FastMCP("DocumentMCP", log_level="ERROR")

これにより、ツール定義、クライアント接続、メッセージルーティングを処理できる、完全に機能するMCPサーバーが作成されます。

デコレータによるツール定義

私たちのMCPサーバーのreadおよびupdateツールが、document.pdf、spreadsheet.xlsx、report.txt、spec.mdの4つのファイルに接続されている様子。

SDKのデコレータ方式により、手動でJSONスキーマを書く必要がなくなります。シンプルなツールを定義する方法は次のとおりです。

python
@mcp.tool(
    name="add_ints",
    description="Add two integers together",
)
def tool_fn(
    a=Field(description="First number to add"),
    b=Field(description="Second number to add"),
) -> int:
    return a + b

裏側では、Claudeがツールをいつ、どのように使用すべきかを理解するために必要な完全なツールスキーマを、MCPが生成しています。

ドキュメント読み取りツールの構築

最初のツールは、IDによってドキュメントの内容を読み取ります。ドキュメント識別子を受け取り、メモリ上の辞書から対応するコンテンツを返します。

python
@mcp.tool(
    name="read_doc_contents",
    description="Read the contents of a document and return it as a string."
)
def read_document(
    doc_id: str = Field(description="Id of the document to read")
):
    if doc_id not in docs:
        raise ValueError(f"Doc with id {doc_id} not found")
    
    return docs[doc_id]

この関数には、存在しないドキュメントへのリクエストを捕捉するための基本的なエラーハンドリングが含まれています。Claudeが有効なドキュメントIDでこのツールを呼び出すと、ドキュメントの全内容が文字列として返されます。

ドキュメント編集ツールの作成

2つ目のツールは、ドキュメントに対するシンプルな検索・置換操作を行います。ドキュメントID、検索する文字列、置換後の文字列という3つのパラメータが必要です。

python
@mcp.tool(
    name="edit_document",
    description="Edit a document by replacing a string in the documents content with a new string."
)
def edit_document(
    doc_id: str = Field(description="Id of the document that will be edited"),
    old_str: str = Field(description="The text to replace. Must match exactly, including white space."),
    new_str: str = Field(description="The new text to insert in place of the old text.")
):
    if doc_id not in docs:
        raise ValueError(f"Doc with id {doc_id} not found")
    
    docs[doc_id] = docs[doc_id].replace(old_str, new_str)

この実装では、Pythonに組み込まれている文字列のreplaceメソッドを使用しており、空白も含めて完全に一致する必要があります。このツールは、辞書内のドキュメントをその場で書き換えます。

SDKアプローチの主な利点

  • JSONスキーマを手動で書く必要がない
  • 型ヒントによってパラメータの自動検証が行われる
  • フィールドの説明により、Claudeがツールの使い方を理解しやすくなる
  • エラーハンドリングがPythonの例外と自然に統合される
  • デコレータを通じてツール登録が自動的に行われる

MCP Python SDKは、ツール作成を複雑なスキーマ記述作業から、シンプルなPython関数定義へと変えてくれます。ツールの保守性とテストのしやすさが向上する一方で、Claudeはそれらを効果的に使用するために必要なメタデータをすべて取得できます。