파이썬 MCP Cat 정보

SSE(Server-Sent Events) 전송을 사용하여 고양이 사실을 제공하는 모델 컨텍스트 프로토콜(MCP)을 구현하는 FastAPI 서버입니다.

특징

• 무작위로 고양이 한 마리의 사실을 알아보세요

• 10초마다 전달되는 고양이 관련 사실 스트림을 구독하세요

• 실시간 통신을 위한 SSE(Server-Sent Events)

• 자동 OpenAPI 문서화를 갖춘 FastAPI 프레임워크

Related MCP server: FastAPI MCP SSE

요구 사항

• 파이썬 3.12+

• 종속성:

  • 패스트아피

  • mcp[cli]

  • 유비콘

  • cmake

설치

저장소를 복제합니다

지엑스피1

가상 환경 만들기

python -m venv venv
source venv/bin/activate  # On Windows, use: venv\Scripts\activate

종속성 설치

pip install -e .

SSE 모드에서 서버 시작

uv run 명령을 사용하여 서버를 시작합니다.

uv run start

서버가 실행되면 다음 위치에서 사용할 수 있습니다.

• API: http://localhost:8000

• API 문서: http://localhost:8000/docs

VS 코드 통합

VS Code와 함께 이 MCP 서버를 사용하려면 mcp.json 파일에 다음 구성을 추가해야 합니다.

{
    "servers": {
        "mcp-sse": {
            "type": "sse",
            "url": "http://0.0.0.0:8000/sse"
        }
    }
}

이 구성은 VS Code가 SSE 전송을 사용하여 MCP 서버에 연결하는 방법을 알려줍니다.

Cat Facts API 사용

고양이 한 마리에 대한 사실을 알아보세요:

SSE 엔드포인트에 연결하여 단일 고양이 정보를 요청하세요. 응답은 항상 "Hi!"로 시작합니다.

API 엔드포인트

• GET / : 홈페이지

• GET /about : 애플리케이션에 대한 정보

• GET /status : 현재 서버 상태

• GET /sse : MCP 통신을 위한 SSE 엔드포인트

• GET /docs : API 문서(Swagger UI)

• GET /redoc : 대체 API 문서(ReDoc)

특허

MIT