iT邦幫忙

2025 iThome 鐵人賽

DAY 12
2
自我挑戰組

攔截記憶碼:每日一小時記錄技術學習系列 第 12

Day 11 - FastAPI-MCP:讓你的 API 一鍵變成 MCP 工具

  • 分享至 

  • xImage
  •  

攔截源頭

  • 發現管道:社群分享
  • 攔截 Github:FastAPI-MCP
  • 攔截原因:我最近一直在玩 MCP,把各種工具接到 Claude Code。發現 FastAPI-MCP 可以將用 Fast API 開發的後端 API Server 無痛變成 MCP 供 AI 使用,立馬心動來試試

技術初探

  • 官方定義:FastAPI-MCP 可以把你的 FastAPI endpoints 直接暴露成 MCP 工具,內建認證,支援零配置上線
  • 核心賣點:
    • FastAPI 原生:不是單純的 OpenAPI 轉換器
    • 零(少)配置:指定 FastAPI app 就能自動生成 MCP server
    • 完整保留 schema 與文件:Swagger 有什麼,MCP 就有什麼
    • 認證支援:繼承 FastAPI dependencies,安全不打折
    • 部署彈性:可以 mount 到同一個 app,或獨立部署
  • 適用場景:
    • 已經有一個 FastAPI 專案,想快速接到 Claude Code 或其他 MCP client
    • 想要讓 AI agent 調用自己的 API
    • 想保留完整 schema / 說明文件,方便開發者與 agent 使用

實戰使用

快速安裝

# 推薦用 uv
uv add fastapi-mcp

# 或用 pip
pip install fastapi-mcp

Hello World

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP

app = FastAPI()

@app.get("/hello")
def hello(name: str):
    return {"message": f"Hello {name}"}

# 啟用 MCP
mcp = FastApiMCP(app)
mcp.mount()

Claude Code Desktop Setting

可以參考:tadata

{
  "mcpServers": {
    "fastapi-mcp": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

記憶碼摘要

技術:FastAPI-MCP
分類:框架擴充 / MCP Adapter
難度:⭐⭐⭐☆☆(1-5顆星)
實用度:⭐⭐⭐⭐⭐(1-5顆星)
一句話:一行程式碼,讓你的 FastAPI API 變成 MCP 工具
關鍵指令:pip install fastapi-mcp
適用情境:已經有 FastAPI 專案,想快速連到 Claude Code / MCP

結語

我覺得 FastAPI-MCP 就像是「把 API 變成 AI 工具」的捷徑。對於有現成 FastAPI 專案的人來說,不用再花時間寫 adapter 或 mapping,幾行程式就能接入 MCP,超省力。

這讓我意識到:AI 生態系正朝「協定優先」的方向走,只要你的 API 接上 MCP,就能馬上被各種 AI 工具使用。未來 API 不只是服務給人,而是服務給 AI agent。


上一篇
Day 10 - AI Elements:幫你快速組裝 AI 應用的 UI 積木庫
下一篇
Day 12 - tldr:命令列速查小抄
系列文
攔截記憶碼:每日一小時記錄技術學習14
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言