MCP Server Cookiecutter Template

🚀 MCP サーバーテンプレート

このMCPサーバーテンプレートは、MCPサーバーの開発を支援するためのテンプレートです。必要な依存関係のインストールやサーバーの起動、APIの使用方法などが含まれています。

🚀 クイックスタート

1. 依存関係のインストール

pip install -r requirements.txt

2. サーバーの起動

make dev
uvicorn run --host 0.0.0.0 --port 8000 mcp.server.fastmcp.cli:create_app

3. 使用例

http://localhost:8000/processにリクエストを送信します。

{
    "data": {
        "input": "処理するデータ",
        "parameters": {}
    }
}

💻 使用例

基本的な使用法

# サーバーの起動
import uvicorn
from fastapi import FastAPI
from mcp.server.fastmcp.routers import main_router

def create_app():
    app = FastAPI()
    app.include_router(main_router.router)
    return app

if __name__ == "__main__":
    uvicorn.run("mcp.server.fastmcp.cli:create_app", host="0.0.0.0", port=8000, reload=True)

高度な使用法

# 提示テンプレートの管理
from typing import List, Dict, Any
from langchain.prompts import PromptTemplate as LangPromptTemplate
from fastapi import APIRouter

prompt_router = APIRouter()

@prompt_router.get("/prompts", response_class=JSONResponse)
async def list_prompts() -> List[Dict[str, str]]:
    # すべての利用可能な提示テンプレートをリストする
    pass

@prompt_router.post("/prompts", response_class=JSONResponse)
async def create_prompt(request: dict) -> Dict[str, Any]:
    # 新しい提示テンプレートを作成する
    pass

@prompt_router.get("/prompts/{prompt_id}", response_class=JSONResponse)
async def get_prompt(prompt_id: str) -> Dict[str, Any]:
    # 指定された提示テンプレートの詳細情報を取得する
    pass

@prompt_router.put("/prompts/{prompt_id}", response_class=JSONResponse)
async def update_prompt(prompt_id: str, data: dict) -> Dict[str, Any]:
    # 指定された提示テンプレートの内容を更新する
    pass

@prompt_router.delete("/prompts/{prompt_id}", response_class=JSONResponse)
async def delete_prompt(prompt_id: str) -> Dict[str, Any]:
    # 指定された提示テンプレートを削除する
    pass

📚 ドキュメント

• APIドキュメント: ブラウザで http://localhost:8000/docs を開く
• 提示テンプレート管理: /prompts ルート
• 対話管理: /dialogs ルート

🔧 技術詳細

ディレクトリ構造

your-project-name/
├── Makefile           # プロジェクトのビルドと実行スクリプト
├── setup.py          # 依存関係のインストールと実行可能スクリプト
├── requirements.txt  # プロジェクトの依存関係リスト
├── mcp/
│   ├── __init__.py    # パッケージの初期化ファイル
│   └── server/
│       ├── __init__.py    # パッケージの初期化ファイル
│       └── fastmcp/
│           ├── __init__.py    # パッケージの初期化ファイル
│           ├── prompts/       # 提示テンプレートモジュール
│           │   └── sample_prompts.py     # サンプル提示テンプレートの実装
│           └── dialogs/        # 対話管理モジュール
│               └── sample_dialogs.py      # サンプル対話の実装

サポートされるインターフェース

1. 提示テンプレート管理インターフェース

• /prompts:
  • GET: すべての提示テンプレートをリストする
  • POST: 新しい提示テンプレートを作成する
  • PUT: 指定された提示テンプレートを更新する
  • DELETE: 指定された提示テンプレートを削除する

2. 対話管理インターフェース

• /dialogs:
  • POST: 新しい対話を作成する
  • GET: 指定された対話の状態を取得する
  • PUT: 指定された対話の内容を更新する
  • DELETE: 指定された対話を削除する

返却形式

{
    "id": "string",          # 一意の識別子
    "status": "success" | "error",
    "message": "操作成功" | "エラーメッセージ"
}

📄 注意事項

⚠️ 重要提示

依存関係をインストールする前に、setuptools と wheel がインストールされていることを確認してください。

💡 使用建议

このプロジェクトは Python 3.8+ を使用しており、仮想環境の使用をおすすめします。すべてのインターフェースはJSON形式のリクエストとレスポンスをサポートしています。