Fitness Api

🚀 MCP Server

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

🚀 クイックスタート

このMCPサーバーを使用することで、指定されたOpenAPI URLに対応した機能を実現できます。以下に、サーバーのセットアップ、開発、実行、ビルドと公開の手順を説明します。

✨ 主な機能

• 指定されたOpenAPI URLに対応したMCPサーバーを提供します。
• 異なるトランスポートモード（stdio、sse、streamable-http）をサポートします。
• ruffによるコードのリントとフォーマット、mypyによる静的型チェック、pytestによるテストを行います。

📦 インストール

前提条件

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

📚 ドキュメント

開発

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

リントとフォーマット

リントの問題をチェックするには：

ruff check

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

ruff format

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

静的解析

静的解析（mypy、bandit、semgrep）を実行するには：

./scripts/static-analysis.sh

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

テストの実行

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

./scripts/test.sh

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

./scripts/test-cov.sh

プリコミットフック

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

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 スクリプトを介しても利用できます。