Pythonservermcp

🚀 Python サーバ MCP - 暗号通貨価格サービス

このプロジェクトは、MCP（モデルコンテキストプロトコル）サーバを実装し、暗号通貨の価格情報を提供します。このサーバはPythonとMCPフレームワークを使用して構築され、様々なクライアントが利用できるAPIを作成します。

🚀 クイックスタート

このサーバを使用することで、暗号通貨の価格情報を簡単に取得できます。以下の手順に従って、サーバをセットアップしてください。

✨ 主な機能

• リアルタイムの暗号通貨価格取得
• 環境設定（開発、本番、ステージング、ローカル）
• CoinMarketCap API 統合
• Dockerコンテナデプロイ

📦 インストール

必要条件

• Python 3.12+
• uv（パッケージと仮想環境マネージャ）
• Docker（コンテナ実行用、オプション）

使用uv（推奨）

# リポジトリをクローン
git clone <repository-url>
cd PythonServerMcp

uvを使って仮想環境を作成してアクティブ化

uv venv
source .venv/bin/activate

依存関係をインストール

uv sync

📚 ドキュメント

コンフィグレーション

1. プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を含めます。

ENVIRONMENT=DEV  # オプション：LOCAL, DEV, STAGING, PROD
COINMARKETCAP_API_KEY=your_api_key_here

2. 各環境に特定の環境ファイルを作成することもできます。
   • .dev.env - 開発環境
   • .staging.env - ステージング環境
   • .prod.env - 本番環境

Dockerによるビルド

docker build -t mcp/python-server-mcp -f Dockerfile .

mcp.json ファイルの設定

{
  "mcpServers": {
    "python-server-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "8000:8000",
        "-e",
        "ENVIRONMENT",
        "-e",
        "COINMARKETCAP_API_KEY",
        "mcp/python-server-mcp"
      ],
      "env": {
        "ENVIRONMENT": "PRODUCTION",
        "COINMARKETCAP_API_KEY": "your-api-key"
      }
    }
  }
}

💻 使用例

ローカル実行

python main.py

これにより、MCPサーバが起動し、標準入出力（stdio）を介してリクエストを待ち受けます。

Dockerを使用する場合

# イメージをビルド
docker build -t test-mcp -f Dockerfile --platform linux/amd64 .

# コンテナを実行
docker run -it test-mcp

🔧 技術詳細

プロジェクト構造

.
├── main.py
└── src
    ├── __init__.py
    ├── core
    │   ├── common
    │   │   ├── crypto_schema.py
    │   │   └── schema.py
    │   ├── config.py
    │   ├── settings
    │   │   ├── __init__.py
    │   │   ├── base.py
    │   │   ├── development.py
    │   │   ├── environment.py
    │   │   ├── local.py
    │   │   ├── production.py
    │   │   └── staging.py
    │   └── utils
    │       ├── datetime.py
    │       ├── extended_enum.py
    │       ├── filename_generator.py
    │       ├── passwords.py
    │       ├── query_utils.py
    │       └── redis.py
    ├── mcp_server.py
    ├── resources
    │   ├── __init__.py
    │   └── coinmarketcap_resource.py
    ├── server.py
    ├── services
    │   ├── __init__.py
    │   └── coinmarketcap_service.py
    └── tools
        ├── __init__.py
        └── prices.py

MCPサーバへの新しいツールの追加

MCPサーバに新しいツールを追加するには、以下の手順に従ってください。

1. src/__init__.py ファイルで関数を定義します。
2. main() 関数でツールを登録します。
3. ツールをドキュメント文字列で記録します。

@server.add_tool
def my_new_tool(parameter1: str, parameter2: int) -> str:
    """
    ツールの機能を説明します。
    
    Args:
        parameter1: パラメータ1の説明
        parameter2: パラメータ2の説明
        
    Returns:
        戻り値の説明
    """
    # ツールの実装
    return result