MCP Server Example

🚀 PythonでMCPサーバーを作成する - 実用的なチュートリアル

このリポジトリは、Microsoftの公式SDKを使用してPythonでMCP（モデルコンテキストプロトコル）サーバーを作成する方法を示しています。このプロジェクトでは、ChatGPTやOpen WebUI環境の他の大規模言語モデルで使用できるツール (@tool) を定義する方法をデモンストレーションしています。

🚀 クイックスタート

このプロジェクトは、PythonでMCPサーバーを作成する方法を示しています。以下のセクションでは、使用する技術、インストール手順、プロジェクト構造、サンプルコード、および実行方法について説明します。

✨ 主な機能

• Pythonを使用してMCPサーバーを作成する。
• ChatGPTや他の大規模言語モデルで使用できるツールを定義する。

📦 インストール

# 1. uvを使用して仮想環境を作成する
uv venv .venv
source .venv/bin/activate

# 2. MCP SDK、CLI、およびmcpoをインストールする
uv add mcp mcp[cli] mcpo

📚 ドキュメント

🚀 使用される技術

• Python 3.10+
• uv - 環境とパッケージを管理する
• mcp - マイクロソフトの公式MCP SDK
• mcpo - HTTPミドルウェア + OpenAPIドキュメント

🧩 プロジェクト構造

📁 プロジェクト/
├── main.py         # MCPサーバーを含むメインファイル
├── README.md       # このファイル
└── .venv/          # 仮想環境（バージョン管理不要）

💻 使用例

基本的な使用法

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("チュートリアルMCPサーバー")

@mcp.tool()
def get_tutorial_summary():
    """
    MCPサーバーを構築する方法に関するチュートリアルの要約を返します。

    :return: テキスト形式のチュートリアルの要約。
    """
    return (
        "uvを使用して環境を構成します。\n"
        "インストールコマンド：uv add mcp mcp[cli] mcpo\n"
        "@toolを持つ関数を実装します\n"
        "実行方法：mcpo\n"
        "MCPクライアントまたはOpen WebUIを介して消費します。"
    )

@mcp.tool()
def somar(a: int, b: int) -> int:
    """
    2つの整数の合計を返します。

    :param a: 最初の数字。
    :param b: 2番目の数字。
    :return: aとbの合計結果。
    """
    return a + b

if __name__ == "__main__":
    mcp.run(transport="stdio")  # ローカルで実行

高度な使用法

🔹 1. ローカルモード（stdio）

.venv/bin/python main.py

または

mcp run main.py # 標準的な方法でサーバーを実行する

mcp dev main.py # 開発者モードでサーバーをテストする

mcp install main.py # Claude Desktopでローカルにインストールする

このモードは、MCP CLIとのローカルテストに適しています。

🔹 2. mcpoを使用したHTTPモード（OpenAPIドキュメント）

mcpo --port 8000 -- .venv/bin/python main.py

• ドキュメントに自動的に表示されます。
• ユーザーのクエリに基づいて、LLMで使用される基準になります。

🔥 明確なdocstringは、LLMとの対話体験を大幅に向上させることができます。

📄 ライセンス

原文書にライセンス情報が記載されていないため、このセクションは表示されません。

📢 貢献

Pull requestsを歓迎します！新しいツールの追加、サンプルの改善、またはチュートリアルの拡張など、自由に提案してください。