MCP Tool Server Template

MCP ツールサーバーテンプレート

FastAPI、uv、Docker に対応した Model Context Protocol（MCP）ツールサーバーを作成するための Cookiecutter テンプレートです。

特長

• FastAPI ベースの REST サーバー
• Model Context Protocol（MCP）ツールに対応
• サンプルの天気ツールを実装
• 最新の Python ツール（uv、ruff、mypy）
• 型ヒントと包括的なテスト
• コンテナ化に対応した Docker サポート
• Kubernetes デプロイ設定

要件

• Python 3.12 以降
• uv パッケージマネージャー
• cookiecutter 2.5.0 以降

使い方

新しいプロジェクトの作成

cookiecutter gh:mibexx/mbxai-mcp-server-template

プロンプトに従って、プロジェクトを設定してください。

• project_name：プロジェクト名
• project_slug：プロジェクトのスラッグ（パスやインポートで使用）
• package_name：Python パッケージ名
• description：プロジェクトの簡単な説明
• author_name：名前
• author_email：メールアドレス
• open_source_license：プロジェクトのライセンス
• python_version：使用する Python のバージョン
• use_pytest：テストに pytest を含めるかどうか
• use_mypy：型チェックに mypy を含めるかどうか
• use_ruff：リンティングに ruff を含めるかどうか

プロジェクト構成

このテンプレートでは、整理されたプロジェクト構成が作成されます。

your-project/
├── src/
│   └── your_package/
│       ├── api/                  # Core API functionality
│       ├── clients/              # Client libraries
│       ├── project/              # Project-specific code
│       │   └── weather.py        # Sample weather tool
│       ├── config.py             # Configuration management
│       └── __init__.py           # Package initialization
├── tests/                        # Test suite
├── data/                         # Data storage
├── logs/                         # Log files
├── kubernetes/                   # Kubernetes deployment files
├── Dockerfile                    # Docker configuration
├── docker-compose.yml            # Docker Compose configuration
├── pyproject.toml                # Project metadata and dependencies
└── README.md                     # Project documentation

開発

ローカルでの実行

cd your-project
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
uv pip install -e .
uv run service

Docker での実行

cd your-project
docker-compose up -d

Kubernetes へのデプロイ

cd your-project
kubectl apply -f kubernetes/mbxai_resource.yaml

新しいツールの追加

MCP サーバーに新しいツールを追加する詳しい手順については、プロジェクトの README.md を参照してください。

ライセンス

このテンプレートは MIT ライセンスの下で提供されています。詳細については LICENSE ファイルを参照してください。

概要

Mibexx が作成しました。