MCP Ynu

🚀 MCP-YNU - FastMCP サーバー

FastMCP を使用して実装された動的 MCP サーバーで、対応するディレクトリから自動的にツール、リソース、プロンプトを読み込むことができます。

🚀 クイックスタート

この MCP サーバーは、FastMCP を利用して動的にモジュールを読み込むことができます。以下の手順に従ってサーバーを起動しましょう。

必要条件

• Python 3.8 以上
• FastMCP と関連する依存関係のインストール

サーバーの起動

1. 適切なディレクトリにモジュールを作成します。
2. from mcp_server import mcp を使用して MCP をインポートします。
3. 以下のコマンドでサーバーを起動します。

python main.py

✨ 主な機能

• tools/、resources/、prompts/ ディレクトリからのモジュールの動的読み込み
• モジュールの自動検出と登録
• シンプルな設定と拡張性
• 型ヒント付きのコードで、コードの明瞭さと静的解析能力を向上
• サーバーの活動を監視するための包括的なログ記録

🆕 最近の更新

• コードベース全体に型ヒントを追加
• MCP インスタンスの処理を改善
• ログ機能を追加
• MIT ライセンスを追加
• ドキュメント内の参照リンクを更新

📁 ディレクトリ構造

mcp-ynu/
├── tools/          # ツールモジュールのディレクトリ
│   ├── __init__.py
│   ├── example.py
├── resources/      # リソースモジュールのディレクトリ
│   ├── __init__.py
│   ├── example.py
├── prompts/        # プロンプトモジュールのディレクトリ
│   ├── __init__.py
│   ├── example.py
├── logger.py       # ログ記録の実装
├── main.py         # メインプログラムの実装
├── mcp_server.py   # MCP サーバーの実装
├── README.md       # プロジェクトのドキュメント
├── LICENSE         # MIT ライセンス
└── pyproject.toml  # プロジェクトの設定

💻 使用例

基本的な使用法

ツールモジュールの例 (tools/example.py)

from mcp_server import mcp
import httpx

@mcp工具()
def calculate_bmi(weight_kg: float, height_m: float) -> float:
    """体重（キログラム）と身長（メートル）から BMI を計算する"""
    return weight_kg / (height_m**2)


@mcp工具()
async def fetch_weather(city: str) -> str:
    """指定された都市の現在の天気を取得する"""
    async with httpx.AsyncClient() as client:
        response = await client.get(f"https://api.weather.com/{city}")
        return response.text

リソースモジュールの例 (resources/example.py)

from mcp_server import mcp

@mcp资源("config://app")
def get_config() -> str:
    """静的な設定データ"""
    return "アプリケーションの設定情報"


@mcp资源("users://{user_id}/profile")
def get_user_profile(user_id: str) -> str:
    """動的なユーザーデータ"""
    return f"ユーザー {user_id} のプロファイル情報"

プロンプトモジュールの例 (prompts/example.py)

from mcp_server import mcp
from mcp.server.fastmcp.prompts import base

@mcp提示()
def review_code(code: str) -> str:
    return f"以下のコードをレビューしてください:\n\n{code}"


@mcp提示()
def debug_error(error: str) -> list[base.Message]:
    return [
        base.UserMessage("このエラーを見ました："),
        base.UserMessage(error),
        base.AssistantMessage("デバッグを支援します。"),
    ]

🐞 デバッグ手順

1. 環境変数 MCP_DEBUG=1 を設定してデバッグモードを有効にします。
2. ターミナルで以下のコマンドを実行してサーバーを起動します。

python main.py --debug

3. デバッグ情報を取得するためにコンソール出力を確認します。

🔗 参考リンク

• FastMCP 公式ドキュメント
• Python 公式ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンスの下で保護されています。詳細は LICENSE を参照してください。