Patronus MCP Server

🚀 モデルコンテキストプロトコル (MCP) サーバー実装

このプロジェクトは、Python で実装された Model Context Protocol (MCP) のサーバー実装です。MCP は、AI モデルとの対話やコンテキスト情報の取得に使用されるプロトコルです。このプロジェクトは、開発者がプラグインを通じて新しい機能やツールを追加できる拡張可能なフレームワークを提供します。

✨ 主な機能

• 組み込みツールのサポート：ネットワークリクエスト、ファイル操作、データ分析など、複数の事前定義されたツールを提供します。
• 動的なプラグインのロード：プラグイン形式で機能を動的に拡張でき、保守とアップグレードが容易です。
• 非同期タスク処理：非同期プログラミングモデルを採用しており、高い並行性のタスクを効率的に処理できます。
• ログとモニタリング：完全なログ記録とパフォーマンスモニタリング機能が統合されており、デバッグと最適化が容易です。

🚀 クイックスタート

📦 インストール

pip install -r requirements.txt

設定の初期化

config.yaml ファイルを作成します。

logging:
  level: INFO
  file: logs/app.log
  rotate: true
services:
  plugins:
    - plugin1
    - plugin2

サービスの起動

python -m src.patronus_mcp.server --config config.yaml

💻 使用例

基本的な使用法

ネットワークリクエストツール

from patronus import tool

@tool()
def fetch_url(url: str) -> dict:
    """指定されたURLからデータを取得する"""
    response = requests.get(url)
    return json.loads(response.text)

ファイル操作ツール

from typing import List, Optional
from patronus import tool

@tool()
def read_file(path: str, encoding: Optional[str] = 'utf-8') -> List[str]:
    """ファイルの内容を読み取り、行のリストを返す"""
    with open(path, 'r', encoding=encoding) as f:
        return [line.strip() for line in f.readlines()]

📚 ドキュメント

プロジェクト構造

patronus-mcp-server/
├── src/
│   └── patronus_mcp/
│       ├── __init__.py
│       └── server.py
├── tests/
│   └── test_server.py
    └── test_live.py
├── pyproject.toml
└── README.md

新機能の追加

1. server.py で新しいリクエストモデルを定義します。

class NewFeatureRequest(BaseModel):
    field1: str
    field2: Optional[int] = None

2. @mcp.tool() デコレータを使用して新機能を実装します。

@mcp.tool()
def new_feature(request: Request[NewFeatureRequest]) -> Any:
    """新しいビジネスロジックを実装する"""
    pass

3. テストファイルに対応するテストケースを追加します。

def test_new_feature():
    request = Request(...)
    response = new_feature(request)
    assert isinstance(response, ...)

テストの実行

単体テスト

pytest tests/test_server.py -v

統合テスト

pytest tests/test_live.py -v

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。以下は完全なライセンス内容です。

著作権 (c) 年、著者名
このソフトウェアは、以下の条件に従って使用、複製、変更、配布することができます。

1. 再配布または派生作品において、著作権表示とこのライセンス表示を保持すること。
2. ソフトウェアに関する虚偽の宣伝や主張を行わないこと。
   このソフトウェアは「現状のまま」提供され、明示または黙示を問わず、商品性、特定の目的への適合性、非侵害性を含むいかなる保証もないことを前提とします。

🔗 貢献ガイド

1. このプロジェクトのリポジトリを Fork します。
2. 新しい機能ブランチを作成します：git checkout -b feature/new-feature
3. コードの変更をコミットします：git add . && git commit -m '新機能の追加'
4. リモートリポジトリにプッシュします：git push origin feature/new-feature
5. メインブランチに Pull Request を送信します。

📞 連絡先

• プロジェクトのメールアドレス：contact@example.com
• 開発者交流グループ：QQ グループ に参加してください。
• 公式ドキュメント：公式ドキュメントサイト を訪問してください。

⚠️ 重要提示

この翻訳内容は原文の構造と情報を維持し、文字のみを日本語に変換しています。