MCP Server Template For Better Ai Coding

🚀 MCP サーバーテンプレート、効率的な AI コーディングのため

このテンプレートは、Python で Model Context Protocol (MCP) サーバーを構築するための効率的な基礎実装を提供します。AI 支援による MCP ツール開発をより効率的かつ直感的にすることを目的としています。

MCP 公式チュートリアルに触発されました。

🚀 クイックスタート

このテンプレートは、Python で Model Context Protocol (MCP) サーバーを構築するための効率的な基礎実装を提供します。AI 支援による MCP ツール開発をより効率的かつ直感的にすることを目的としています。

✨ 主な機能

• すぐに使える MCP サーバー実装
• 設定可能な転送モード（標準入出力、SSE）
• サンプルの天気サービス統合（NWS API）
• 明確で文書化されたコード構造
• 最小限の依存関係
• 組み込みの MCP 仕様とドキュメントにより、AI ツールの理解能力を向上させます。

✨ Cursor Rules の統合

このプロジェクトでは、AI コーディング支援の品質を向上させるために Cursor Rules を使用しており、Awesome Cursor Rules のパターンを組み合わせています。

• コードクリーンガイド：組み込まれたクリーンコードルールは、一貫性と品質を維持するのに役立ちます。
• AI の理解能力向上：ルールは AI アシスタントにコンテキストを提供し、より良質なコードを生成できるようにします。
• 標準化されたパターン：MCP サーバー実装のベストプラクティスに従っています。

Cursor Rules は、AI コーディングアシスタントと人間の開発者が共同で高水準のコード品質を維持し、既定のベストプラクティスに従うのを支援します。

✨ 統合型 MCP ドキュメント

このテンプレートには、プロジェクトに直接組み込まれた包括的な MCP ドキュメントが含まれています。

• 完全な MCP 仕様 (protocals/mcp.md)：AI モデルが外部ツールやリソースとどのように相互作用するかを詳細に説明するプロトコル。これにより、AI ツールは外部参照なしで MCP 概念を理解できます。
• Python SDK 使用ガイド (protocals/sdk.md)：MCP Python SDK の詳細なドキュメント。これにより、AI ツールは正確なコード提案を提供しやすくなり、ライブラリの機能を完全に理解できます。
• サンプル実装 (protocals/example_weather.py)：実際の天気サービスの実装で、現実世界の MCP サーバーパターンとベストプラクティスを示しています。

これらのリソースをプロジェクトに組み込むことで、AI コーディングアシスタントは MCP 概念をよりよく理解し、開発中により正確でコンテキストに関連した提案を提供できるようになります。

📦 インストール

前提条件

• Python 3.12 以上のバージョン
• 依存関係：
  • mcp>=1.4.1
  • httpx>=0.28.1
  • starlette>=0.46.1
  • uvicorn>=0.15.0

依存関係のインストール

必要な Python パッケージを以下のコマンドでインストールします。

pip install mcp httpx starlette uvicorn

リポジトリのクローン

このテンプレートをローカルマシンにクローンします。

git clone https://github.com/yourusername/mcp-server-template.git
cd mcp-server-template

💻 使用例

サーバーの起動

ターミナルで以下のコマンドを実行して、MCP サーバーを起動します。

uvicorn main:app --reload

これにより、自動リロード機能を持つ開発サーバーがデフォルトのポート 8000 で起動します。

API の呼び出し

以下の curl コマンドを使用して、基本的な API 機能をテストします。

curl http://localhost:8000/api/hello

📚 ドキュメント

プロジェクト構造

プロジェクトの典型的なディレクトリ構造は次のとおりです。

mcp-server-template/
├── main.py           # メインアプリケーションのエントリポイント
├── config.py         # 設定管理
├── routes/           # ルート定義
│   └── api.py        # API ルート
├── middleware/       # ミドルウェア
│   └── auth.py       # 認証ミドルウェア
└── templates/        # テンプレートファイル
    └── index.html     # デフォルトのテンプレート

学習リソース

• MCP 公式ドキュメント
• プロトコルドキュメント
• SDK 使用ガイド

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT License でライセンスされています。詳細は LICENSE ファイルを参照してください。