Fastapi Todo Listapp Mcpserver

🚀 FastAPI Todo List with MCP Server (2025)

このアプリケーションはFastAPIを用いて構築されたモダンなTodoリストで、FastMCPを使ってMCP（Model Context Protocol）サーバーと統合され、Gemini CLIとのやり取りが可能です。

🚀 クイックスタート

以下のコマンドを使って、すぐに始めることができます。

# 依存関係のインストール
pip install -r requirements.txt

# FastAPIの起動 (ターミナル1)
python main.py

# MCPサーバーの起動 (ターミナル2)
python mcp_server.py

# APIのテスト
curl http://localhost:8000/todos/stats

✨ 主な機能

• ✅ Todoに対する完全なCRUD操作
• 📊 タスク追跡のための統計エンドポイント
• 🔌 FastMCP (2025) を使用したMCPサーバー
• 📝 事前にロードされたダミーデータ (5つのタスク)
• 🤖 Gemini CLIとの統合
• 🎯 たった2つのファイルで簡単にセットアップ

📦 インストール

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

pip install -r requirements.txt

2. FastAPIサーバーの起動

python main.py

APIは以下のURLで利用できます。

• APIベース: http://localhost:8000
• ドキュメント: http://localhost:8000/docs
• 統計エンドポイント: http://localhost:8000/todos/stats

3. MCPサーバーの起動 (ターミナル2)

python mcp_server.py

💻 使用例

基本的な使用法

FastAPIの直接テスト

# すべてのTodoを取得
curl http://localhost:8000/todos

# 統計を取得
curl http://localhost:8000/todos/stats

# 新しいTodoを作成
curl -X POST "http://localhost:8000/todos" \
     -H "Content-Type: application/json" \
     -d '{"title": "Test Todo", "description": "Created via curl"}'

MCPサーバーのテスト

python mcp_server.py

これにより接続をテストし、現在のTodoを表示します。

高度な使用法

Gemini CLIとのやり取り

サーバーが起動したら、Gemini CLIに以下のような質問をすることができます。

• "How many tasks are left?" → 未完了のタスク数を取得
• "Show me all my todos" → すべてのタスクをリスト表示
• "Create a new task called Review code" → 新しいタスクを追加
• "Mark task 1 as completed" → タスクのステータスを更新
• "Delete task 3" → タスクを削除

📚 ドキュメント

APIエンドポイント

MCPサーバーツール

MCPサーバーはGemini CLI用に以下のツールを提供します。

• get_todos - すべてのTodoを取得
• get_todo_stats - 統計（合計、完了、未完了）を取得
• create_todo - 新しいTodoを作成
• update_todo - 既存のTodoを更新
• delete_todo - Todoを削除
• get_todo_by_id - 特定のTodoの詳細を取得

Gemini CLIの設定

.gemini/settings.json ファイルを使って、Gemini CLIをMCPサーバーに接続するように設定します。

{
  "mcpServers": {
    "todo-mcp-server": {
      "command": "python3",
      "args": ["mcp_server.py"],
      "cwd": "/home/okki/Desktop/projects/fast-apimcp"
    }
  }
}

🔧 技術詳細

技術スタック

ダミーデータ

このアプリケーションには5つのダミーTodoが事前にロードされています。

1. Learn FastAPI (未完了) - FastAPIのチュートリアルを完了する
2. Build MCP Server (未完了) - Gemini CLI用のMCPサーバーを作成する
3. Test Integration (未完了) - FastAPIとMCPサーバーをテストする
4. Deploy Application (完了) - 本番環境にデプロイする
5. Write Documentation (未完了) - APIドキュメントを作成する

統計の例

{
  "total_todos": 5,
  "completed_todos": 1,
  "pending_todos": 4,
  "completion_percentage": 20.0
}

🐛 トラブルシューティング

一般的な問題と解決策

⚠️ 重要提示

以下は一般的な問題とその解決策です。

• "Cannot connect to FastAPI"
  • FastAPIが最初に起動していることを確認してください: python main.py
• "Module not found: fastmcp"
  • fastmcpをインストールしてください: pip install fastmcp
• "Port 8000 already in use"
  • 他のサービスを停止するか、main.py でポートを変更してください
• MCPサーバーが接続できない場合
  • .gemini/settings.json の設定を確認してください
  • 両方のサーバーが起動していることを確認してください

📹 デモビデオ

デモ動画を見るには、FastAPI Todo List with MCP Server Demo をクリックしてください。

すべてが正常に動作すると、以下のようになります。

• ✅ FastAPIがTodo APIを提供
• ✅ MCPサーバーがFastAPIに接続
• ✅ Gemini CLIがTodoを管理できる
• ✅ リアルタイムのTodo統計
• ✅ 自然言語によるTodo管理

生産性とタスク追跡に最適です！ 🚀