Motor Vehicle Department Maharashtra

🚀 MCP Server

このプロジェクトは、指定されたOpenAPI URL - https://api.apis.guru/v2/specs/apisetu.gov.in/transportmh/3.0.0/openapi.json 用のMCP (Model Context Protocol) サーバーです。AG2の MCPビルダー を使用して自動生成されています。

🚀 クイックスタート

このMCPサーバーを使用することで、指定されたOpenAPI仕様に基づいたモデルコンテキストプロトコルを実装できます。以下の手順に従って、サーバーをセットアップして実行しましょう。

✨ 主な機能

• 自動生成: AG2のMCPビルダーを使用して、指定されたOpenAPI URLから自動生成されます。
• 複数のトランスポートモード: stdio、sse、streamable-http などの異なるトランスポートモードをサポートしています。
• 環境変数による設定: CONFIG_PATH、CONFIG、SECURITY などの環境変数を使用してサーバーを設定できます。

📦 インストール

前提条件

• Python 3.9+
• pipとuv

手順

1. リポジトリをクローンします:

   git clone <repository-url>
   cd mcp-server
   

2. 依存関係をインストールします: .devcontainer/setup.sh スクリプトは pip install -e ".[dev]" を使用して依存関係のインストールを処理します。開発コンテナを使用していない場合は、このコマンドを手動で実行できます。

   pip install -e ".[dev]"
   

   あるいは、uv を使用することもできます:

   uv pip install --editable ".[dev]"
   

💻 使用例

基本的な使用法

サーバーを起動するには、次のコマンドを実行します (例: stdioモードで):

python mcp_server/main.py stdio

高度な使用法

サーバーは環境変数を使用して設定できます。たとえば、JSON構成ファイルのパスを指定するには、次のようにします:

export CONFIG_PATH=mcp_server/mcp_config.json
python mcp_server/main.py stdio

📚 ドキュメント

開発

このプロジェクトは、コードのlintingとフォーマットに ruff、静的型チェックに mypy、テストに pytest を使用しています。

Lintingとフォーマット

lintingの問題をチェックするには:

ruff check

コードをフォーマットするには:

ruff format

これらのコマンドは、scripts/lint.sh スクリプトを介しても利用できます。

静的解析

静的解析 (mypy、bandit、semgrep) を実行するには:

./scripts/static-analysis.sh

このスクリプトは、.pre-commit-config.yaml でpre-commitフックとしても設定されています。

テストの実行

カバレッジ付きでテストを実行するには:

./scripts/test.sh

これにより、pytestが実行され、カバレッジレポートが生成されます。結合レポートとクリーンアップを行うには、次のコマンドを使用できます:

./scripts/test-cov.sh

Pre-commitフック

このプロジェクトは、.pre-commit-config.yaml で定義されたpre-commitフックを使用しています。フックをインストールするには:

pre-commit install

これらのフックは、各コミットの前に自動的に実行されます。

サーバーの実行

MCPサーバーは、mcp_server/main.py スクリプトを使用して起動できます。異なるトランスポートモード (例: stdio、sse、streamable-http) をサポートしています。

サーバーを起動するには (例: stdioモードで):

python mcp_server/main.py stdio

サーバーは環境変数を使用して設定できます:

• CONFIG_PATH: JSON構成ファイルのパス (例: mcp_server/mcp_config.json)。
• CONFIG: 構成を含むJSON文字列。
• SECURITY: セキュリティパラメータの環境変数 (例: APIキー)。

これらがどのように読み込まれるかの詳細については、mcp_server/main.py の if __name__ == "__main__": ブロックを参照してください。

tests/test_mcp_server.py ファイルは、テストのためにサーバーをプログラムで起動してやり取りする方法を示しています。

ビルドと公開

このプロジェクトは、ビルドと公開にHatchを使用しています。 プロジェクトをビルドするには:

hatch build

プロジェクトを公開するには:

hatch publish

これらのコマンドは、scripts/publish.sh スクリプトを介しても利用できます。