Code MCP Server

🚀 MCP サーバー

FastAPI をベースにした Model-Controller-Provider (MCP) アーキテクチャのサーバー実装です。このサーバーは、高性能な REST API を提供し、MCP アーキテクチャによってデータモデル、ビジネスロジック、データアクセスを効果的に分離します。

🚀 クイックスタート

環境の作成

# codeMcpServer という名前の新しい環境を Python 3.12 で作成
conda create -n codeMcpServer python=3.12
# 環境をアクティブ化
conda activate codeMcpServer

依存関係のインストール

# 提供された環境ファイルを使用（推奨）
conda env create -f environment.yml

# または pip を使用
pip install -r requirements.txt

# または conda と conda-forge チャネルを使用
conda config --add channels conda-forge
conda install --file requirements.txt

サーバーの起動

uvicorn main:app --reload

サーバーは http://localhost:8000 で起動します。

✨ 主な機能

• FastAPI ベースの REST API：高性能、使いやすさ、高速なコーディングが可能です。
• MCP アーキテクチャ：
  • モデル：データ構造とデータベーススキーマ。
  • コントローラー：ビジネスロジックとリクエスト処理。
  • プロバイダー：データアクセスと外部サービスの統合。
• 最新の技術スタック：
  • SQLAlchemy を使用した ORM。
  • Pydantic を使用したデータ検証。
  • FastAPI を使用した API フレームワーク。
  • SQLite を使用した開発用データベース。
• API の機能：
  • 自動 OpenAPI ドキュメント。
  • リクエスト検証。
  • レスポンスのシリアライズ。
  • CORS ミドルウェア。
  • 型チェック。

📦 インストール

環境の作成

# codeMcpServer という名前の新しい環境を Python 3.12 で作成
conda create -n codeMcpServer python=3.12
# 環境をアクティブ化
conda activate codeMcpServer

依存関係のインストール

# 提供された環境ファイルを使用（推奨）
conda env create -f environment.yml

# または pip を使用
pip install -r requirements.txt

# または conda と conda-forge チャネルを使用
conda config --add channels conda-forge
conda install --file requirements.txt

サーバーの起動

uvicorn main:app --reload

サーバーは http://localhost:8000 で起動します。

💻 使用例

基本的な使用法

サーバーを起動した後、以下の URL で API ドキュメントを参照できます。

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

📚 ドキュメント

プロジェクト内の docs ディレクトリを参照して、完全な API ドキュメントと実装の詳細を確認してください。

🔧 技術詳細

プロジェクト構造

.
├── api/              # API ルートとエンドポイント
│   └── v1/          # API バージョン 1
│       ├── __init__.py
│       └── items.py # アイテムエンドポイント
├── controllers/      # ビジネスロジックとリクエストハンドラー
│   └── item_controller.py
├── providers/       # データアクセスと外部サービスの統合
│   └── item_provider.py
├── models/         # データモデルとデータベーススキーマ
│   └── item.py
├── core/          # コア設定とツール
│   ├── config.py  # アプリケーション設定
│   └── database.py # データベース設定
├── main.py        # アプリケーションのエントリポイント
├── requirements.txt # プロジェクトの依存関係
├── environment.yml  # Conda 環境ファイル
└── README.md      # プロジェクトドキュメント

依存関係

• Python 3.12.9
• FastAPI 0.112.2
• SQLAlchemy 2.0.37
• Pydantic 2.11.2
• Uvicorn 0.32.1
• Python-dotenv 0.21.0

完全な依存関係のリストは、environment.yml または requirements.txt を参照してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。