Simple MCP Server With Python

🚀 Python MCP SDKを使用したシンプルなサーバーの構築

このチュートリアルでは、Model Context Protocol (MCP) Python SDKを使用してシンプルなサーバーを構築します。インストール、設定、サーバーの起動までの手順を段階的に案内し、コマンドラインでのやり取り方法も紹介します。

🚀 クイックスタート

📦 インストール

まず、プロジェクト環境にMCP Python SDKをインストールする必要があります。

pip install mcp-sdk

💻 使用例

基本的な使用法

新しいPythonファイル server.py を作成し、以下のコードを追加します。

# server.py
from mcp import Server, StdioTransport

if __name__ == "__main__":
    # 初始化 MCP 服务器
    server = Server()
    
    @server.tool("add")
    async def add_tool(arguments):
        a = arguments["a"]
        b = arguments["b"]
        return f"{int(a) + int(b)}"
    
    @server.resource("greeting://{name}")
    async def greeting_resource(name):
        return f"Hello, {name}!"
    
    # 使用标准输入输出作为默认传输协议
    transport = StdioTransport()
    server.start(transport)

ターミナルで以下のコマンドを実行してサーバーを起動します。

python server.py

この時点で、サーバーはバックグラウンドで静かに動作し、クライアントの接続とリクエストを待機します。

高度な使用法

別のPythonファイル client.py を作成し、以下のコードを追加してサーバーに接続します。

# client.py
import asyncio
from mcp import Server, ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    server_params = StdioServerParameters(
        command="python",
        args=["server.py"],
    )

    async with stdio_client(server_params) as (reader, writer):
        async with ClientSession(reader, writer) as session:
            await session.initialize()

            # 调用 add 工具
            result = await session.call_tool("add", arguments={"a": 3, "b": 4})
            print(f"加法工具的结果: {result}")

if __name__ == "__main__":
    asyncio.run(main())

別のターミナルウィンドウで以下のコマンドを実行してクライアントを起動します。

python client.py

出力結果は以下のようになります。

加法工具的结果: TextContent(type='text', text='7', annotations=None)

🔧 サーバー機能の拡張

サーバーの機能を拡張するには、より多くのツールやリソースを追加できます。例えば、電卓ツールを追加するには以下のコードを使用します。

@server.tool("calculator")
async def calculator_tool(arguments):
    operation = arguments["operation"]
    a = int(arguments["a"])
    b = int(arguments["b"])
    
    if operation == "add":
        return a + b
    elif operation == "subtract":
        return a - b
    elif operation == "multiply":
        return a * b
    elif operation == "divide":
        return a / b
    else:
        raise ValueError("无效的运算操作")

🛠 MCPチェックツールの使用

MCPには、サーバーが正しく動作しているかを検証するためのコマンドラインツール mcp-check が用意されています。以下のようにインストールして使用します。

pip install mcp-check
mcp-check http://localhost:1234

📚 ドキュメント

結論

このチュートリアルを通じて、MCP Python SDKを使用してシンプルなサーバーを構築し、ツールやリソースの追加方法を紹介しました。これを基に機能を拡張し、より複雑なシステムを構築することができます。

付録：よくある質問

Q：サーバーが応答しないのはなぜですか？

A：サーバーが動作していること、およびクライアントが正しいアドレスとポートに接続していることを確認してください。ファイアウォールやネットワーク設定が接続を妨げていないかも確認してください。

Q：カスタムリソースをどのように処理しますか？

A：サーバー上でカスタムリソースパスを登録することができます。例えば、 @server.resource("custom/{id}") を使用し、対応するデータを返します。

Q：MCPはどのようなトランスポートプロトコルをサポートしていますか？

A：標準入出力の他に、MCPはWebSocketやHTTPなどの他のトランスポートプロトコルもサポートしています。必要に応じて選択して設定することができます。

このチュートリアルを通じて、MCP Python SDKを使用して基本的なサーバーを構築するスキルを習得しました。開発の過程で成功を収めますように！