Pokapi：OpenAPIベースのMCPサーバー、多様な伝送モードと全プロセス開発ツールを提供

たんさく

Pokapi

これはOpenAPIベースのMCP（多エージェント対話プロトコル）サーバープロジェクトで、さまざまな転送モードをサポートし、完全な開発、テスト、およびリリースプロセスを提供します。

人工知能チャットボットゲームとゲーム化 #多エージェント #対話プロトコル #APIサービス #Python開発 .Python

スコア : 2ポイント

ダウンロード数 : 8.6K

更新時間 : 2025-07-24

サイトを開く

MCPサーバーとは？

MCPサーバーは、Multi - Agent Conversation Protocol（MCP）に準拠したバックエンドサービスで、ユーザーが簡単なコマンドでPokémon APIとやり取りできます。このサーバーはさまざまなリクエストを処理し、構造化されたレスポンスを提供します。

MCPサーバーの使い方は？

MCPサーバーを使用するには、まず必要な依存関係をインストールし、設定に従ってサーバーを起動します。コマンドラインまたはプログラミングによってサーバーとやり取りし、Pokémon関連のデータ情報を取得できます。

適用シナリオ

MCPサーバーは、Pokémon関連のアプリ開発、チャットボットの構築、ゲームツールの作成、またはPokémonデータとのやり取りが必要なあらゆるシナリオに適しています。

主要機能

OpenAPI統合

MCPサーバーは、Pokémon APIのOpenAPIドキュメントを直接統合しており、最新のデータとの整合性を保証します。

多プロトコルサポート

標準入出力（stdio）やServer - Sent Events（SSE）など、さまざまな通信プロトコルをサポートし、さまざまなアプリケーションシナリオに対応します。

高い設定可能性

サーバーは環境変数または設定ファイルを使用して柔軟に設定でき、さまざまなデプロイメント要件を満たします。

テストとデバッグサポート

完全なテストフレームワークとデバッグツールを提供し、開発者が機能とパフォーマンスを検証しやすくします。

利点

既存のプロジェクトへの統合が容易

複数の通信プロトコルをサポートし、高い柔軟性

豊富なテストツールとドキュメントを提供

複雑なPokémonデータの照会を処理できる

制限

設定と実行には一定の技術的基礎が必要

非技術ユーザーにとって、初期設定が複雑になる可能性がある

一部の高度な機能のサポートが制限されている

使い方

依存関係のインストール

リポジトリをクローンし、必要なPythonパッケージをインストールします。Python 3.9以上がインストールされていることを確認してください。

サーバーの起動

メインスクリプトを実行してMCPサーバーを起動し、異なる転送モードを選択できます。

サーバーとのやり取り

コマンドラインまたはプログラミングによってサーバーにリクエストを送信し、Pokémon関連の情報を取得します。

使用例

特定のPokémonの情報を照会する

ユーザーは特定のPokémonの詳細情報（名前、タイプ、技など）を取得したいと考えています。

すべてのPokémonのリストを取得する

ユーザーはすべてのPokémonの名前と基本情報を表示したいと考えています。

よくある質問

MCPサーバーに必要な技術的基礎は何ですか？

MCPサーバーのインストール問題をどう解決しますか？

MCPサーバーはどのような通信プロトコルをサポートしていますか？

MCPサーバーの設定をどのようにカスタマイズしますか？

🚀 MCP Server

このプロジェクトは、指定されたOpenAPI URL（https://raw.githubusercontent.com/PokeAPI/pokeapi/refs/heads/master/openapi.yml）用のMCP（Multi - Agent Conversation Protocol）サーバーです。AG2のMCPビルダーを使用して自動生成されています。

🚀 クイックスタート

このMCPサーバーは、特定のOpenAPI仕様に基づいて構築されたサーバーです。以下の手順に従って、サーバーをセットアップし、実行することができます。

✨ 主な機能

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

📦 インストール

前提条件

Python 3.9以上
pipとuv

インストール手順

リポジトリをクローンします。

git clone <repository-url>
cd mcp-server

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

💻 使用例

基本的な使用法

サーバーの起動

MCPサーバーは、mcp_server/main.pyスクリプトを使用して起動することができます。異なるトランスポートモード（例：stdio、sse）をサポートしています。

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__":ブロックを参照して、これらがどのように読み込まれるかを確認してください。