FastAPI-MCP: FastAPI 서버를 MCP Server로 간단하게 전환하는 라이브러리

from fastapi import FastAPI
from fastapi_mcp import add_mcp_server

app = FastAPI()

# FastAPI 앱에 MCP 서버를 마운트합니다.
# '/mcp' 경로에 "My API MCP"라는 이름으로 MCP 서버가 생성됩니다.
add_mcp_server(app, mount_path="/mcp", name="My API MCP")

# 이제 FastAPI 앱을 실행하면 /mcp 경로에서 MCP 서버가 함께 동작합니다.
# 예: uvicorn main:app --reload

from fastapi import FastAPI
from fastapi_mcp import add_mcp_server

app = FastAPI()

@app.get("/items/{item_id}")
async def read_item(item_id: int, q: str | None = None):
    return {"item_id": item_id, "q": q}

add_mcp_server(
    app,
    mount_path="/custom-mcp-path",  # MCP 서버의 마운트 경로 변경
    name="My Advanced API MCP",    # MCP 서버의 이름 지정
    describe_all_responses=True,   # 모든 응답에 대한 설명을 포함할지 여부
    describe_full_response_schema=True # 전체 응답 스키마를 설명에 포함할지 여부
)

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP # FastApiMCP 클래스를 임포트
from datetime import datetime

app = FastAPI()

# 1. FastApiMCP 인스턴스 생성
mcp_server = FastApiMCP(app, name="My Custom Tools MCP")

# 2. @mcp_server.tool() 데코레이터를 사용하여 사용자 정의 함수를 MCP 도구로 등록
@mcp_server.tool()
async def get_server_time() -> str:
    """현재 서버의 ISO 형식 시간 문자열을 반환합니다."""
    return datetime.now().isoformat()

# 3. MCP 서버를 FastAPI 앱에 마운트 (기본 경로는 /mcp)
mcp_server.mount(mount_path="/my-tools-mcp")

# FastAPI 엔드포인트 예시
@app.get("/hello")
async def hello():
    return {"message": "Hello World"}

# FastAPI-MCP는 /hello 엔드포인트도 자동으로 MCP 도구로 변환합니다.
# 그리고 get_server_time 함수는 별도의 MCP 도구로 추가됩니다.

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP

app = FastAPI()    

mcp = FastApiMCP(
    app,
    name="내 API MCP",
    base_url="http://localhost:8000",
    describe_all_responses=True,  # 가능한 모든 응답 스키마 포함
    describe_full_response_schema=True  # 전체 JSON 스키마 세부정보 포함
)    

# FastAPI 앱에 MCP 서버 마운트
mcp.mount()

# operation_id를 정의하여, 도구로써 네이밍을 정의할 수 있음
@app.get("/users/{user_id}", operation_id="get_user_info")
async def read_user(user_id: int):
    return {"user_id": user_id}
    
# operation ID로 특정 작업"get_user_info" 만 포함해서 MCP서버로 응답이 가능하도록 filtering
mcp = FastApiMCP(
    app,
    include_operations=["get_user_info"]
)    

# operation ID로 특정 작업만 포함
mcp = FastApiMCP(
    app,
    include_operations=["get_user", "create_user"]
)

# 특정 작업 제외
mcp = FastApiMCP(
    app,
    exclude_operations=["delete_user"]
)

# 태그별 필터
mcp = FastApiMCP(
    app,
    include_tags=["users", "public"]
)

# 태그별 제외
mcp = FastApiMCP(
    app,
    exclude_tags=["admin", "internal"]
)

# 필터링 전략 결합
mcp = FastApiMCP(
    app,
    include_operations=["user_login"],
    include_tags=["public"]
)

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from typing import List, Optional
from fastapi_mcp import FastApiMCP

app = FastAPI(title="TODO API")

class TodoItem(BaseModel):
id: Optional[int] = None
title: str
description: Optional[str] = None
completed: bool = False

todos = []
counter = 1

@app.post("/todos/", response_model=TodoItem)
async def create_todo(todo: TodoItem):
"""새로운 할 일을 생성합니다."""
global counter
todo.id = counter
counter += 1
todos.append(todo)
return todo

@app.get("/todos/", response_model=List[TodoItem])
async def get_todos():
"""모든 할 일 목록을 반환합니다."""
return todos

@app.get("/todos/{todo_id}", response_model=TodoItem)
async def get_todo(todo_id: int):
"""특정 ID의 할 일을 반환합니다."""
for todo in todos:
if todo.id == todo_id:
return todo
raise HTTPException(status_code=404, detail="Todo not found")

# MCP 서버 추가
mcp = FastApiMCP(app)
mcp.mount()

# 사용자 정의 MCP 도구 추가
@mcp.tool()
async def count_todos() -> int:
"""할 일의 총 개수를 반환합니다."""
return len(todos)