Python Server MCP - 暗号通貨価格サービス
このプロジェクトは、暗号通貨の価格情報を提供するMCP（Model Context Protocol）サーバーを実装します。このサーバーはPythonとMCPフレームワークを使用して構築され、さまざまなクライアントが利用できるAPIを作成します。
特徴
- リアルタイムの暗号通貨価格検索
- 環境ベースの構成（開発、本番、ステージング、ローカル）
- CoinMarketCap API統合
- Dockerコンテナのデプロイメント
要件
- Python 3.12以上
- uv (パッケージおよび仮想環境マネージャー)
- Docker（オプション、コンテナ実行用）
インストール
uvの使用（推奨）
# Clone the repository
git clone <repository-url>
cd PythonServerMcp
UVで仮想環境を作成してアクティブ化する
uv venv
source .venv/bin/activate
依存関係をインストールする
uv sync
構成
- 次の変数を含む
.envファイルをプロジェクト ルートに作成します。
ENVIRONMENT=DEV # Options: LOCAL, DEV, STAGING, PROD
COINMARKETCAP_API_KEY=your_api_key_here
- 各環境ごとに特定の環境ファイルを作成することもできます。
.dev.env - 開発環境用.staging.env - ステージング環境用.prod.env - 本番環境用
使用法
ローカル実行
これにより、標準入出力 (stdio) を介して要求をリッスンする MCP サーバーが起動します。
Dockerの使用
# Build the image
docker build -t test-mcp -f Dockerfile --platform linux/amd64 .
# Run the container
docker run -it test-mcp
プロジェクト構造
.
├── Dockerfile # Docker configuration
├── main.py # Application entry point
├── pyproject.toml # Dependencies configuration
├── start.sh # Docker startup script
└── src/ # Source code
├── __init__.py # MCP server initialization
└── core/ # Core modules
├── common/ # Shared schemas and models
├── config.py # Application configuration
├── services/ # Application services
├── settings/ # Environment-specific settings
└── utils/ # Utilities
発達
MCP サーバーに新しいツールを追加する
MCP サーバーに新しいツールを追加するには、次の手順に従います。
src/__init__.pyファイルで関数を定義するmain()関数でツールを登録する- ドキュメント文字列でツールを文書化する
例：
@server.add_tool
def my_new_tool(parameter1: str, parameter2: int) -> str:
"""
Description of what the tool does.
Args:
parameter1: Description of parameter 1
parameter2: Description of parameter 2
Returns:
Description of what is returned
"""
# Tool implementation
return result