Fastapi Todo Listapp Mcpserver

🚀 2025版FastAPI待辦事項列表與MCP服務器

這是一個使用FastAPI構建的現代待辦事項列表應用程序，它通過FastMCP集成了MCP（模型上下文協議）服務器，可與Gemini CLI進行交互，為用戶提供便捷的待辦事項管理體驗。

🚀 快速開始

按照以下步驟快速啟動項目：

# 安裝依賴
pip install -r requirements.txt

# 在終端1啟動FastAPI
python main.py

# 在終端2啟動MCP服務器
python mcp_server.py

# 測試API
curl http://localhost:8000/todos/stats

✨ 主要特性

• ✅ 支持待辦事項的完整CRUD操作。
• 📊 提供任務統計端點，方便跟蹤任務狀態。
• 🔌 使用FastMCP（2025）構建的MCP服務器。
• 📝 預加載5條虛擬數據，方便測試。
• 🤖 支持與Gemini CLI集成。
• 🎯 僅需2個文件，即可完成簡單設置。

📦 安裝指南

1. 安裝依賴

pip install -r requirements.txt

2. 啟動FastAPI服務器

python main.py

API的訪問地址如下：

• API基礎地址：http://localhost:8000
• 文檔地址：http://localhost:8000/docs
• 統計端點：http://localhost:8000/todos/stats

3. 啟動MCP服務器（在另一個終端中執行）

python mcp_server.py

💻 使用示例

基礎用法

以下是一些使用curl命令測試API的示例：

# 獲取所有待辦事項
curl http://localhost:8000/todos

# 獲取統計信息
curl http://localhost:8000/todos/stats

# 創建新的待辦事項
curl -X POST "http://localhost:8000/todos" \
     -H "Content-Type: application/json" \
     -d '{"title": "Test Todo", "description": "Created via curl"}'

高級用法

可以使用MCP服務器提供的工具與Gemini CLI進行交互，例如：

python mcp_server.py

這將測試連接並顯示當前的待辦事項。

📚 詳細文檔

📊 API端點

🔌 MCP服務器工具

MCP服務器為Gemini CLI提供了以下工具：

• get_todos - 獲取所有待辦事項
• get_todo_stats - 獲取統計信息（總數、已完成、待處理）
• create_todo - 創建新的待辦事項
• update_todo - 更新現有待辦事項
• delete_todo - 刪除待辦事項
• get_todo_by_id - 獲取特定待辦事項的詳細信息

🤖 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"
    }
  }
}

示例命令

當兩個服務器都運行後，你可以向Gemini CLI提問：

• "還剩多少任務？" → 獲取待處理任務數量
• "顯示所有待辦事項" → 列出所有任務
• "創建一個名為審查代碼的新任務" → 添加新任務
• "將任務1標記為已完成" → 更新任務狀態
• "刪除任務3" → 刪除任務

🔧 技術細節

本項目使用的技術棧如下：

• FastAPI - 現代Python Web框架
• FastMCP - 現代MCP服務器庫（2025）
• Pydantic - 數據驗證和序列化
• Uvicorn - ASGI服務器
• httpx - 異步HTTP客戶端

📝 虛擬數據

應用程序預加載了5條虛擬待辦事項：

1. 學習FastAPI（待處理） - 完成FastAPI教程
2. 構建MCP服務器（待處理） - 為Gemini CLI創建MCP服務器
3. 測試集成（待處理） - 測試FastAPI與MCP服務器的集成
4. 部署應用程序（已完成） - 部署到生產環境
5. 編寫文檔（待處理） - 創建API文檔

📈 統計示例

以下是一個統計信息的示例：

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

🐛 故障排除

常見問題

1. "無法連接到FastAPI"

   • 確保先啟動FastAPI：python main.py

2. "找不到模塊：fastmcp"

   • 安裝fastmcp：pip install fastmcp

3. "端口8000已被佔用"

   • 停止其他服務或在main.py中更改端口

4. MCP服務器無法連接

   • 檢查.gemini/settings.json配置
   • 確保兩個服務器都在運行

📹 演示視頻

觀看演示視頻：2025版FastAPI待辦事項列表與MCP服務器演示

一切就緒後，你將擁有：

• ✅ 提供待辦事項API的FastAPI
• ✅ 連接到FastAPI的MCP服務器
• ✅ 能夠管理待辦事項的Gemini CLI
• ✅ 即時待辦事項統計信息
• ✅ 自然語言待辦事項管理功能

非常適合提高生產力和任務跟蹤！ 🚀