Google Play Game Management

🚀 MCP Server

このプロジェクトは、指定されたOpenAPI URL - https://api.apis.guru/v2/specs/googleapis.com/gamesManagement/v1management/openapi.json のためのMCP（Model Context Protocol）サーバーです。AG2のMCPビルダーを使用して自動生成されています。

🚀 クイックスタート

このセクションでは、MCP Serverの基本的な使い方を説明します。まずは前提条件を確認し、インストールを行い、サーバーを起動する手順を紹介します。

✨ 主な機能

• 指定されたOpenAPI URLに対応したMCPサーバーを提供します。
• 異なるトランスポートモード（stdio, sse, streamable-http）をサポートしています。
• 環境変数を使用したサーバーの設定が可能です。

📦 インストール

前提条件

• 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]"
   

💻 使用例

基本的な使用法

サーバーを起動するには、mcp_server/main.py スクリプトを使用します。例えば、stdio モードでサーバーを起動するには以下のコマンドを実行します。

python mcp_server/main.py stdio

高度な使用法

サーバーは環境変数を使用して設定することができます。以下は設定可能な環境変数の例です。

# CONFIG_PATH: JSON設定ファイルへのパス
export CONFIG_PATH=mcp_server/mcp_config.json
# CONFIG: 設定を含むJSON文字列
export CONFIG='{"key": "value"}'
# SECURITY: セキュリティパラメータの環境変数（例: APIキー）
export SECURITY='{"api_key": "your_api_key"}'
python mcp_server/main.py stdio

📚 ドキュメント

開発に関する情報

このプロジェクトでは、コードの品質を保つためにいくつかのツールを使用しています。

コードの検査と整形

コードの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

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

サーバーのビルドと公開

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

hatch build

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

hatch publish

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