[{"_1":2,"_393":-5,"_394":-5},"loaderData",{"_3":4,"_22":23,"_289":290},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",22248096,"membership","referenceId","019a3c9b-43cc-72d8-8c00-496521d6e6ee","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":41,"_206":207,"_288":193},"availableLocales",[],"githubUser","locale",{"_29":30,"_37":38,"_39":40},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Production-ready API server template integrating FastAPI with Model Context Protocol (MCP) for LLM integration, structured logging, and comprehensive testing.","displayName","FastAPI MCP Template","readme","# FastAPI + MCP Template\n\n> **현대적인 API 서버와 MCP(Model Context Protocol) 통합 템플릿**\n\nFastAPI와 MCP를 활용한 프로덕션 수준의 API 서버 템플릿입니다. LLM 통합, 구조화된 로깅, 포괄적인 테스트, 그리고 최고의 개발자 경험을 제공합니다.\n\n[![Python](https://img.shields.io/badge/Python-3.11+-blue?style=flat-square&logo=python)](https://python.org)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.104+-green?style=flat-square&logo=fastapi)](https://fastapi.tiangolo.com)\n[![MCP](https://img.shields.io/badge/MCP-FastMCP-purple?style=flat-square)](https://github.com/jlowin/fastmcp)\n[![License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](https://opensource.org/licenses/MIT)\n\n## ✨ 주요 특징\n\n### 🚀 **프로덕션 수준의 API 서버**\n\n- **현대적인 FastAPI**: 자동 API 문서화, 타입 안전성, 고성능\n- **Scalar 문서화**: 아름답고 대화형 API 문서\n- **구조화된 로깅**: 색상 지원, 파일 로테이션, 요청 추적\n- **포괄적인 예외 처리**: 타입별 커스텀 예외 및 상세한 오류 정보\n- **Dependency Injection**: FastAPI DI 패턴으로 깔끔한 코드 구조\n\n### 🤖 **MCP 서버 통합**\n\n- **FastMCP 구현**: 최신 Model Context Protocol 표준\n- **SSE 통신**: 실시간 Server-Sent Events 연결\n- **도구 및 리소스**: LLM이 활용할 수 있는 다양한 도구\n- **확장 가능**: 새로운 MCP 기능 쉽게 추가\n\n### 🛡️ **보안 및 설정**\n\n- **환경별 설정**: 개발, 테스트, 프로덕션 환경 지원\n- **보안 기본값**: 자동 시크릿 키 생성, CORS 보안 설정\n- **환경변수 관리**: .env 파일 지원 및 완전한 설정 검증\n\n### 🧪 **완전한 테스트 커버리지**\n\n- **단위 테스트**: MCP 도구 및 API 엔드포인트\n- **통합 테스트**: 전체 시스템 엔드투엔드 테스트\n- **동시성 테스트**: 멀티스레드 및 성능 테스트\n\n## 📁 프로젝트 구조\n\n```\ncoupang-partners-api/\n├── 🏗️ 소스 코드\n│ ├── src/\n│ │ ├── core/ # 🔧 핵심 모듈\n│ │ │ ├── config.py # ⚙️ 환경별 설정 관리\n│ │ │ ├── logging.py # 📝 구조화된 로깅 시스템\n│ │ │ ├── exceptions.py # ⚠️ 커스텀 예외 처리\n│ │ │ ├── dependencies.py # 🔗 의존성 주입 패턴\n│ │ │ ├── database.py # 💾 데이터베이스 추상화\n│ │ │ └── models.py # 📋 Pydantic 모델\n│ │ ├── api/ # 🌐 FastAPI 애플리케이션\n│ │ │ ├── app.py # 🚀 메인 애플리케이션\n│ │ │ └── routers/ # 🛣️ API 라우터\n│ │ ├── mcp_server/ # 🤖 MCP 서버\n│ │ │ ├── server.py # 🖥️ MCP 서버 구현\n│ │ │ ├── tools.py # 🔨 MCP 도구\n│ │ │ └── resources.py # 📦 MCP 리소스\n│ │ └── templates/ # 📄 템플릿 파일\n│ ├── 🧪 테스트\n│ │ ├── tests/\n│ │ │ ├── test_api.py # 🌐 API 테스트\n│ │ │ ├── test_mcp.py # 🤖 MCP 테스트\n│ │ │ └── test_integration.py # 🔄 통합 테스트\n│ ├── 📚 예시 및 문서\n│ │ ├── examples/ # 💡 사용 예시\n│ │ └── docs/ # 📖 문서\n│ └── 🐳 배포\n│ ├── Dockerfile # 🐳 Docker 이미지\n│ ├── docker-compose.yml # 🐙 Docker Compose\n│ └── .dockerignore # 🚫 Docker 제외 파일\n├── ⚡ 실행 스크립트\n│ ├── run_server.py # 🚀 통합 서버 실행\n│ ├── run_api_server.py # 🌐 API 서버 실행 \n│ ├── run_mcp_server.py # 🤖 MCP 서버 실행\n│ └── run_docker.py # 🐳 Docker 실행 도구\n├── 🔧 설정 파일\n│ ├── .env.example # 🔑 환경변수 예시\n│ ├── .gitignore # 🚫 Git 제외 파일\n│ ├── pyproject.toml # 📦 프로젝트 설정\n│ └── uv.lock # 🔒 의존성 락 파일\n└── 📋 메타데이터\n ├── README.md # 📖 이 파일\n └── setup_template.py # ⚙️ 템플릿 설정 도구\n```\n\n## 🚀 빠른 시작\n\n### 1️⃣ **환경 설정**\n\n#### 의존성 설치\n\n```bash\n# UV 패키지 매니저 사용 (권장)\nuv sync\n\n# 또는 pip 사용\npip install -r requirements.txt\n\n# 개발 환경 (테스트, 린팅 도구 포함)\npip install -r requirements-dev.txt\n```\n\n#### 환경변수 설정\n\n```bash\n# 환경변수 파일 복사 및 수정\ncp .env.example .env\n```\n\n**`.env` 파일 주요 설정:**\n\n```bash\n# 애플리케이션 설정\nAPP_NAME=\"My Awesome API\"\nENVIRONMENT=\"development\" # development, production, test\n\n# 보안 설정\nSECRET_KEY=\"your-secure-random-key-here\"\n\n# CORS 설정 (개발용)\nCORS_ORIGINS=\"http://localhost:3000,http://localhost:8080\"\n\n# 로깅 설정\nLOG_LEVEL=\"INFO\"\nLOG_FILE=\"logs/app.log\"\n```\n\n### 2️⃣ **서버 실행**\n\n#### 🎯 **통합 실행 (권장)**\n\n```bash\n# API + MCP 서버 동시 실행\npython run_server.py\n```\n\n#### 🔄 **개별 실행**\n\n```bash\n# Terminal 1: API 서버 (포트 8000)\npython run_api_server.py\n\n# Terminal 2: MCP 서버 (포트 8001)\npython run_mcp_server.py\n```\n\n#### 🐳 **Docker 실행**\n\n```bash\n# 프로덕션 모드\ndocker-compose up --build\n\n# 개발 모드 (볼륨 마운트)\ndocker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build\n```\n\n### 3️⃣ **접속 확인**\n\n| 서비스 | URL | 설명 |\n|--------|-----|------|\n| 🌐 **API 서버** | | 메인 API 엔드포인트 |\n| 📚 **API 문서** | | 대화형 API 문서 (Scalar) |\n| ❤️ **헬스체크** | | 서버 상태 확인 |\n| 🤖 **MCP 서버** | | MCP SSE 엔드포인트 |\n\n## 🛠️ 템플릿 커스터마이징\n\n### 💡 **빠른 설정**\n\n```bash\n# 대화형 CLI로 프로젝트 정보 설정\npython setup_template.py --customize\n```\n\n### 🆕 **새 프로젝트 생성**\n\n```bash\n# 새 프로젝트 생성\npython setup_template.py --new my-awesome-project\n\n# 특정 디렉토리에 생성\npython setup_template.py --new my-project --target-dir /path/to/projects\n```\n\n### 🔄 **백업에서 복원**\n\n```bash\n# 원래 템플릿 상태로 복원\npython setup_template.py --restore\n```\n\n## 📚 API 문서\n\n### 🏥 **헬스 체크**\n\n```http\nGET /health # 종합 헬스 체크\nGET /health/simple # 간단한 상태 확인\nGET /health/detailed # 상세 시스템 정보\n```\n\n### 📦 **아이템 관리**\n\n```http\nGET /api/v1/items # 아이템 목록 (페이지네이션)\nPOST /api/v1/items # 아이템 생성\nGET /api/v1/items/{id} # 특정 아이템 조회\nPUT /api/v1/items/{id} # 아이템 수정\nDELETE /api/v1/items/{id} # 아이템 삭제\nGET /api/v1/items/search/by-name # 이름으로 검색\nGET /api/v1/items/stats/summary # 통계 정보\n```\n\n### 👥 **사용자 관리**\n\n```http\nGET /api/v1/users # 사용자 목록\nPOST /api/v1/users # 사용자 생성\nGET /api/v1/users/{id} # 특정 사용자 조회\nPUT /api/v1/users/{id} # 사용자 수정\nDELETE /api/v1/users/{id} # 사용자 삭제\n```\n\n### 📖 **API 사용 예시**\n\n#### 아이템 생성\n\n```bash\ncurl -X POST \"http://localhost:8000/api/v1/items\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"노트북\",\n \"description\": \"고성능 개발용 노트북\",\n \"price\": 1200000,\n \"category\": \"electronics\",\n \"is_available\": true,\n \"tags\": [\"laptop\", \"development\"]\n }'\n```\n\n#### 아이템 검색\n\n```bash\ncurl \"http://localhost:8000/api/v1/items?category=electronics&available_only=true&limit=10\"\n```\n\n## 🤖 MCP 서버 기능\n\n### 🔨 **사용 가능한 도구 (Tools)**\n\n| 도구명 | 설명 | 매개변수 |\n|--------|------|----------|\n| `get_items` | 아이템 목록 조회 | `skip`, `limit`, `category`, `available_only` |\n| `get_item_by_id` | ID로 아이템 조회 | `item_id` |\n| `create_item` | 새 아이템 생성 | `name`, `price`, `description`, etc. |\n| `update_item` | 아이템 수정 | `item_id`, 수정할 필드들 |\n| `delete_item` | 아이템 삭제 | `item_id` |\n| `search_items` | 아이템 검색 | `query`, `search_field` |\n| `get_database_stats` | 데이터베이스 통계 | 없음 |\n| `export_database` | 데이터 내보내기 | 없음 |\n\n### 📦 **사용 가능한 리소스 (Resources)**\n\n| 리소스 URI | 설명 |\n|------------|------|\n| `database://schema` | 데이터베이스 스키마 정보 |\n| `docs://api` | API 문서 정보 |\n| `data://items` | 아이템 데이터 |\n| `data://users` | 사용자 데이터 |\n\n### 🎯 **MCP 사용 예시**\n\nMCP 클라이언트에서 도구 호출:\n\n```python\n# 아이템 생성\nresult = await mcp_server.call_tool(\"create_item\", {\n \"name\": \"새 상품\",\n \"price\": 50000,\n \"category\": \"electronics\"\n})\n\n# 아이템 검색\nresult = await mcp_server.call_tool(\"search_items\", {\n \"query\": \"노트북\",\n \"search_field\": \"name\"\n})\n```\n\n## 🧪 테스트\n\n### 🏃 **테스트 실행**\n\n```bash\n# 모든 테스트 실행\npytest\n\n# 커버리지 포함\npytest --cov=src --cov-report=html\n\n# 특정 테스트 모듈\npytest tests/test_api.py -v\n\n# MCP 테스트만 실행\npytest tests/test_mcp.py -v\n\n# 통합 테스트만 실행\npytest tests/test_integration.py -v\n```\n\n### 📊 **테스트 커버리지**\n\n- **API 엔드포인트**: 모든 CRUD 작업 및 오류 시나리오\n- **MCP 도구**: 모든 도구 기능 및 오류 처리\n- **통합 테스트**: API ↔ MCP 데이터 일관성\n- **동시성 테스트**: 멀티스레드 환경에서의 안정성\n- **시스템 한계 테스트**: 대용량 데이터 및 극한 상황\n\n### 🎯 **테스트 예시**\n\n```bash\n# 개발용 빠른 테스트\npytest tests/ -k \"not integration\" --tb=short\n\n# CI/CD용 전체 테스트\npytest tests/ --cov=src --cov-report=xml --junitxml=test-results.xml\n```\n\n## 🚀 배포\n\n### 🐳 **Docker 배포**\n\n#### 프로덕션 빌드\n\n```bash\n# 이미지 빌드\ndocker build -t my-awesome-api .\n\n# 컨테이너 실행\ndocker run -p 8000:8000 -p 8001:8001 my-awesome-api\n```\n\n#### Docker Compose\n\n```bash\n# 프로덕션 환경\ndocker-compose up --build -d\n\n# 로그 확인\ndocker-compose logs -f\n\n# 서비스 중지\ndocker-compose down\n```\n\n### ☁️ **클라우드 배포**\n\n#### Heroku\n\n```bash\n# Heroku CLI 로그인\nheroku login\n\n# 앱 생성\nheroku create my-awesome-api\n\n# 환경변수 설정\nheroku config:set SECRET_KEY=\"your-secret-key\"\nheroku config:set ENVIRONMENT=\"production\"\n\n# 배포\ngit push heroku main\n```\n\n#### AWS ECS / Azure Container Instances\n\n```bash\n# 환경변수 설정 예시\nexport SECRET_KEY=\"your-production-secret-key\"\nexport ENVIRONMENT=\"production\"\nexport CORS_ORIGINS=\"https://yourdomain.com\"\n\n# 컨테이너 실행\ndocker run -p 8000:8000 -p 8001:8001 \\\n -e SECRET_KEY=$SECRET_KEY \\\n -e ENVIRONMENT=$ENVIRONMENT \\\n -e CORS_ORIGINS=$CORS_ORIGINS \\\n my-awesome-api\n```\n\n### 📊 **프로덕션 모니터링**\n\n환경변수 설정:\n\n```bash\n# 로깅 설정\nLOG_LEVEL=\"WARNING\"\nLOG_FILE=\"/var/log/app/app.log\"\n\n# 보안 설정\nSECRET_KEY=\"강력한-랜덤-키-32자-이상\"\nCORS_ORIGINS=\"https://yourdomain.com,https://admin.yourdomain.com\"\n\n# 성능 설정\nDATABASE_URL=\"postgresql://user:pass@host:5432/dbname\"\n```\n\n## 🔧 개발 가이드\n\n### 📝 **새 API 엔드포인트 추가**\n\n1. **모델 정의** (`src/core/models.py`):\n\n```python\nclass NewModel(BaseEntity):\n name: str = Field(..., description=\"이름\")\n value: int = Field(..., description=\"값\")\n```\n\n2. **라우터 생성** (`src/api/routers/new_router.py`):\n\n```python\nfrom fastapi import APIRouter, Depends\nfrom ...core.dependencies import get_database\nfrom ...core.models import NewModel\n\nrouter = APIRouter()\n\n@router.get(\"/items\", response_model=List[NewModel])\nasync def get_items(db: InMemoryDatabase = Depends(get_database)):\n return db.find_all(\"new_items\")\n```\n\n3. **앱에 등록** (`src/api/app.py`):\n\n```python\nfrom .routers import new_router\napp.include_router(new_router.router, prefix=\"/api/v1\", tags=[\"New Items\"])\n```\n\n### 🔨 **새 MCP 도구 추가**\n\n1. **도구 정의** (`src/mcp_server/tools.py`):\n\n```python\n@mcp.tool()\ndef new_tool(context: Context, param1: str, param2: int = 10) -> dict:\n \"\"\"새로운 MCP 도구\"\"\"\n try:\n # 비즈니스 로직\n result = process_data(param1, param2)\n return {\"success\": True, \"result\": result}\n except Exception as e:\n logger.error(f\"Tool error: {e}\")\n return {\"success\": False, \"error\": str(e)}\n```\n\n2. **리소스 추가** (`src/mcp_server/resources.py`):\n\n```python\n@mcp.resource(\"data://new_resource\")\ndef get_new_resource(context: Context) -> str:\n \"\"\"새로운 MCP 리소스\"\"\"\n return json.dumps({\"data\": \"new_resource_data\"})\n```\n\n### 🧪 **테스트 작성**\n\n1. **단위 테스트**:\n\n```python\n@pytest.mark.asyncio\nasync def test_new_tool():\n result = await mcp_server.call_tool(\"new_tool\", {\n \"param1\": \"test\",\n \"param2\": 5\n }, mock_context)\n assert result[\"success\"] == True\n```\n\n2. **통합 테스트**:\n\n```python\ndef test_new_endpoint(client):\n response = client.post(\"/api/v1/new-items\", json={\n \"name\": \"Test Item\",\n \"value\": 100\n })\n assert response.status_code == 201\n```\n\n### 📋 **코딩 스타일**\n\n- **타입 힌트**: 모든 함수에 타입 힌트 사용\n- **Docstring**: Google 스타일 docstring 사용\n- **로깅**: 구조화된 로깅 (`logger.info()`, `logger.error()`)\n- **예외 처리**: 커스텀 예외 클래스 사용\n- **의존성 주입**: FastAPI Depends() 패턴 활용\n\n## 🔍 문제 해결\n\n### 🚨 **일반적인 문제들**\n\n#### 포트 충돌\n\n```bash\n# 포트 사용 확인\nlsof -i :8000\nlsof -i :8001\n\n# 프로세스 종료\nkill -9 \n```\n\n#### 환경변수 설정 오류\n\n```bash\n# 환경변수 확인\npython -c \"from src.core.config import settings; print(settings.dict())\"\n\n# .env 파일 확인\ncat .env\n```\n\n#### 의존성 문제\n\n```bash\n# 의존성 재설치\nuv sync --refresh\n\n# 캐시 정리\nuv cache clean\n```\n\n#### 로그 확인\n\n```bash\n# 애플리케이션 로그\ntail -f logs/app.log\n\n# Docker 로그\ndocker-compose logs -f\n```\n\n### 🔧 **디버깅 팁**\n\n1. **DEBUG 모드 활성화**:\n\n```bash\nexport DEBUG=true\nexport LOG_LEVEL=DEBUG\n```\n\n2. **개발 서버에서 실행**:\n\n```bash\nuvicorn src.api.app:create_app --factory --reload --log-level debug\n```\n\n3. **MCP 서버 단독 테스트**:\n\n```bash\npython -m src.mcp_server.server\n```\n\n## 🤝 기여하기\n\n### 🔄 **기여 워크플로우**\n\n1. **Fork** 저장소\n2. **Feature 브랜치** 생성: `git checkout -b feature/amazing-feature`\n3. **커밋**: `git commit -m 'Add amazing feature'`\n4. **푸시**: `git push origin feature/amazing-feature`\n5. **Pull Request** 생성\n\n### 📋 **기여 가이드라인**\n\n- **코드 스타일**: Black, isort, flake8 사용\n- **테스트**: 새 기능에 대한 테스트 추가\n- **문서화**: Docstring 및 README 업데이트\n- **커밋 메시지**: Conventional Commits 스타일 사용\n\n### 🛠️ **개발 환경 설정**\n\n```bash\n# 개발 의존성 설치\nuv sync --dev\n\n# pre-commit 훅 설치\npre-commit install\n\n# 코드 포맷팅\nblack src/ tests/\nisort src/ tests/\n\n# 린팅\nflake8 src/ tests/\nmypy src/\n```\n\n## 📄 라이선스\n\n이 프로젝트는 [MIT 라이선스](LICENSE) 하에 배포됩니다.\n\n## 🙏 감사의 말\n\n- [FastAPI](https://fastapi.tiangolo.com/) - 현대적인 Python 웹 프레임워크\n- [FastMCP](https://github.com/jlowin/fastmcp) - Model Context Protocol 구현\n- [Pydantic](https://pydantic-docs.helpmanual.io/) - 데이터 검증 및 설정 관리\n- [UV](https://github.com/astral-sh/uv) - 빠른 Python 패키지 매니저\n\n---\n\n

\n 🚀 이 템플릿으로 멋진 API를 만들어보세요! 🚀\n

\n\n

\n 🐛 버그 신고 •\n 💬 토론 •\n 📖 위키\n

\n","name","English","tag","en-US",{"_42":43,"_13":44,"_48":32,"_49":32,"_33":34,"_16":50,"_51":52,"_119":120,"_127":-5,"_128":-5,"_129":130,"_196":197,"_201":-5,"_59":183,"_202":187,"_62":203,"_204":205},"addedAt","2025-06-21T02:01:42.579657Z",[45,46,47],"category:api-testing","category:databases","language:python","descriptionMarkdown","descriptionPlainText",8138,"integrations",[53,64,71,78,85,92,98,105,112],{"_54":55,"_31":61,"_62":63},"brand",{"_56":57,"_37":58,"_59":60},"logoSvgPath","M13.983 11.078h2.119a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.119a.185.185 0 00-.185.185v1.888c0 .102.083.185.185.185m-2.954-5.43h2.118a.186.186 0 00.186-.186V3.574a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m0 2.716h2.118a.187.187 0 00.186-.186V6.29a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.887c0 .102.082.185.185.186m-2.93 0h2.12a.186.186 0 00.184-.186V6.29a.185.185 0 00-.185-.185H8.1a.185.185 0 00-.185.185v1.887c0 .102.083.185.185.186m-2.964 0h2.119a.186.186 0 00.185-.186V6.29a.185.185 0 00-.185-.185H5.136a.186.186 0 00-.186.185v1.887c0 .102.084.185.186.186m5.893 2.715h2.118a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m-2.93 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.083.185.185.185m-2.964 0h2.119a.185.185 0 00.185-.185V9.006a.185.185 0 00-.184-.186h-2.12a.186.186 0 00-.186.186v1.887c0 .102.084.185.186.185m-2.92 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.082.185.185.185M23.763 9.89c-.065-.051-.672-.51-1.954-.51-.338.001-.676.03-1.01.087-.248-1.7-1.653-2.53-1.716-2.566l-.344-.199-.226.327c-.284.438-.49.922-.612 1.43-.23.97-.09 1.882.403 2.661-.595.332-1.55.413-1.744.42H.751a.751.751 0 00-.75.748 11.376 11.376 0 00.692 4.062c.545 1.428 1.355 2.48 2.41 3.124 1.18.723 3.1 1.137 5.275 1.137.983.003 1.963-.086 2.93-.266a12.248 12.248 0 003.823-1.389c.98-.567 1.86-1.288 2.61-2.136 1.252-1.418 1.998-2.997 2.553-4.4h.221c1.372 0 2.215-.549 2.68-1.009.309-.293.55-.65.707-1.046l.098-.288Z","Docker","slug","docker","Supports containerized deployment with Docker and Docker Compose, including production and development configurations with volume mounting for development mode.","uid","cdswzm04vn",{"_54":65,"_31":69,"_62":70},{"_56":66,"_37":67,"_59":68},"M24 0v24H0V0h24ZM10.933 15.89H6.84v5.52h4.198v-.93H7.955v-1.503h2.77v-.93h-2.77v-1.224h2.978v-.934Zm2.146 0h-1.084v5.52h1.035v-3.6l2.226 3.6h1.118v-5.52h-1.036v3.686l-2.259-3.687Zm5.117 0h-1.208l1.973 5.52h1.19l1.976-5.52h-1.182l-1.352 4.085-1.397-4.086ZM5.4 19.68H3.72v1.68H5.4v-1.68Z",".ENV","dotenv","Supports environment variable management through .env files for configuring server settings across different environments.","qdwk1ydtrp",{"_54":72,"_31":76,"_62":77},{"_56":73,"_37":74,"_59":75},"M12 .0387C5.3729.0384.0003 5.3931 0 11.9988c-.001 6.6066 5.372 11.9628 12 11.9625 6.628.0003 12.001-5.3559 12-11.9625-.0003-6.6057-5.3729-11.9604-12-11.96m-.829 5.4153h7.55l-7.5805 5.3284h5.1828L5.279 18.5436q2.9466-6.5444 5.892-13.0896","FastAPI","fastapi","Integrated as the main API server framework, providing automatic API documentation, type safety, and high performance features for the MCP server implementation.","omalwzqyzl",{"_54":79,"_31":83,"_62":84},{"_56":80,"_37":81,"_59":82},"M20.61 0H3.39C2.189 0 1.23.96 1.23 2.16v19.681c0 1.198.959 2.159 2.16 2.159h17.22c1.2 0 2.159-.961 2.159-2.159V2.16C22.77.96 21.811 0 20.61 0zm.96 21.841c0 .539-.421.96-.96.96H3.39c-.54 0-.96-.421-.96-.96V2.16c0-.54.42-.961.96-.961h17.22c.539 0 .96.421.96.961v19.681zM6.63 20.399L9.33 18l-2.7-2.4v4.799zm9.72-9.719c-.479-.48-1.379-1.08-2.879-1.08-1.621 0-3.301.421-4.5.84V3.6h-2.4v10.38l1.68-.78s2.76-1.26 5.16-1.26c1.2 0 1.5.66 1.5 1.26v7.2h2.4v-7.2c.059-.179.059-1.501-.961-2.52zM13.17 7.5h2.4c1.08-1.26 1.62-2.521 1.8-3.9h-2.399c-.241 1.379-.841 2.64-1.801 3.9z","Heroku","heroku","Provides deployment support to Heroku cloud platform with instructions for app creation, environment variable configuration, and deployment via git.","lvzs9lrttd",{"_54":86,"_31":90,"_62":91},{"_56":87,"_37":88,"_59":89},"M23.5594 14.7228a.5269.5269 0 0 0-.0563-.1191c-.139-.2632-.4768-.3418-1.0074-.2321-1.6533.3411-2.2935.1312-2.5256-.0191 1.342-2.0482 2.445-4.522 3.0411-6.8297.2714-1.0507.7982-3.5237.1222-4.7316a1.5641 1.5641 0 0 0-.1509-.235C21.6931.9086 19.8007.0248 17.5099.0005c-1.4947-.0158-2.7705.3461-3.1161.4794a9.449 9.449 0 0 0-.5159-.0816 8.044 8.044 0 0 0-1.3114-.1278c-1.1822-.0184-2.2038.2642-3.0498.8406-.8573-.3211-4.7888-1.645-7.2219.0788C.9359 2.1526.3086 3.8733.4302 6.3043c.0409.818.5069 3.334 1.2423 5.7436.4598 1.5065.9387 2.7019 1.4334 3.582.553.9942 1.1259 1.5933 1.7143 1.7895.4474.1491 1.1327.1441 1.8581-.7279.8012-.9635 1.5903-1.8258 1.9446-2.2069.4351.2355.9064.3625 1.39.3772a.0569.0569 0 0 0 .0004.0041 11.0312 11.0312 0 0 0-.2472.3054c-.3389.4302-.4094.5197-1.5002.7443-.3102.064-1.1344.2339-1.1464.8115-.0025.1224.0329.2309.0919.3268.2269.4231.9216.6097 1.015.6331 1.3345.3335 2.5044.092 3.3714-.6787-.017 2.231.0775 4.4174.3454 5.0874.2212.5529.7618 1.9045 2.4692 1.9043.2505 0 .5263-.0291.8296-.0941 1.7819-.3821 2.5557-1.1696 2.855-2.9059.1503-.8707.4016-2.8753.5388-4.1012.0169-.0703.0357-.1207.057-.1362.0007-.0005.0697-.0471.4272.0307a.3673.3673 0 0 0 .0443.0068l.2539.0223.0149.001c.8468.0384 1.9114-.1426 2.5312-.4308.6438-.2988 1.8057-1.0323 1.5951-1.6698zM2.371 11.8765c-.7435-2.4358-1.1779-4.8851-1.2123-5.5719-.1086-2.1714.4171-3.6829 1.5623-4.4927 1.8367-1.2986 4.8398-.5408 6.108-.13-.0032.0032-.0066.0061-.0098.0094-2.0238 2.044-1.9758 5.536-1.9708 5.7495-.0002.0823.0066.1989.0162.3593.0348.5873.0996 1.6804-.0735 2.9184-.1609 1.1504.1937 2.2764.9728 3.0892.0806.0841.1648.1631.2518.2374-.3468.3714-1.1004 1.1926-1.9025 2.1576-.5677.6825-.9597.5517-1.0886.5087-.3919-.1307-.813-.5871-1.2381-1.3223-.4796-.839-.9635-2.0317-1.4155-3.5126zm6.0072 5.0871c-.1711-.0428-.3271-.1132-.4322-.1772.0889-.0394.2374-.0902.4833-.1409 1.2833-.2641 1.4815-.4506 1.9143-1.0002.0992-.126.2116-.2687.3673-.4426a.3549.3549 0 0 0 .0737-.1298c.1708-.1513.2724-.1099.4369-.0417.156.0646.3078.26.3695.4752.0291.1016.0619.2945-.0452.4444-.9043 1.2658-2.2216 1.2494-3.1676 1.0128zm2.094-3.988-.0525.141c-.133.3566-.2567.6881-.3334 1.003-.6674-.0021-1.3168-.2872-1.8105-.8024-.6279-.6551-.9131-1.5664-.7825-2.5004.1828-1.3079.1153-2.4468.079-3.0586-.005-.0857-.0095-.1607-.0122-.2199.2957-.2621 1.6659-.9962 2.6429-.7724.4459.1022.7176.4057.8305.928.5846 2.7038.0774 3.8307-.3302 4.7363-.084.1866-.1633.3629-.2311.5454zm7.3637 4.5725c-.0169.1768-.0358.376-.0618.5959l-.146.4383a.3547.3547 0 0 0-.0182.1077c-.0059.4747-.054.6489-.115.8693-.0634.2292-.1353.4891-.1794 1.0575-.11 1.4143-.8782 2.2267-2.4172 2.5565-1.5155.3251-1.7843-.4968-2.0212-1.2217a6.5824 6.5824 0 0 0-.0769-.2266c-.2154-.5858-.1911-1.4119-.1574-2.5551.0165-.5612-.0249-1.9013-.3302-2.6462.0044-.2932.0106-.5909.019-.8918a.3529.3529 0 0 0-.0153-.1126 1.4927 1.4927 0 0 0-.0439-.208c-.1226-.4283-.4213-.7866-.7797-.9351-.1424-.059-.4038-.1672-.7178-.0869.067-.276.1831-.5875.309-.9249l.0529-.142c.0595-.16.134-.3257.213-.5012.4265-.9476 1.0106-2.2453.3766-5.1772-.2374-1.0981-1.0304-1.6343-2.2324-1.5098-.7207.0746-1.3799.3654-1.7088.5321a5.6716 5.6716 0 0 0-.1958.1041c.0918-1.1064.4386-3.1741 1.7357-4.4823a4.0306 4.0306 0 0 1 .3033-.276.3532.3532 0 0 0 .1447-.0644c.7524-.5706 1.6945-.8506 2.802-.8325.4091.0067.8017.0339 1.1742.081 1.939.3544 3.2439 1.4468 4.0359 2.3827.8143.9623 1.2552 1.9315 1.4312 2.4543-1.3232-.1346-2.2234.1268-2.6797.779-.9926 1.4189.543 4.1729 1.2811 5.4964.1353.2426.2522.4522.2889.5413.2403.5825.5515.9713.7787 1.2552.0696.087.1372.1714.1885.245-.4008.1155-1.1208.3825-1.0552 1.717-.0123.1563-.0423.4469-.0834.8148-.0461.2077-.0702.4603-.0994.7662zm.8905-1.6211c-.0405-.8316.2691-.9185.5967-1.0105a2.8566 2.8566 0 0 0 .135-.0406 1.202 1.202 0 0 0 .1342.103c.5703.3765 1.5823.4213 3.0068.1344-.2016.1769-.5189.3994-.9533.6011-.4098.1903-1.0957.333-1.7473.3636-.7197.0336-1.0859-.0807-1.1721-.151zm.5695-9.2712c-.0059.3508-.0542.6692-.1054 1.0017-.055.3576-.112.7274-.1264 1.1762-.0142.4368.0404.8909.0932 1.3301.1066.887.216 1.8003-.2075 2.7014a3.5272 3.5272 0 0 1-.1876-.3856c-.0527-.1276-.1669-.3326-.3251-.6162-.6156-1.1041-2.0574-3.6896-1.3193-4.7446.3795-.5427 1.3408-.5661 2.1781-.463zm.2284 7.0137a12.3762 12.3762 0 0 0-.0853-.1074l-.0355-.0444c.7262-1.1995.5842-2.3862.4578-3.4385-.0519-.4318-.1009-.8396-.0885-1.2226.0129-.4061.0666-.7543.1185-1.0911.0639-.415.1288-.8443.1109-1.3505.0134-.0531.0188-.1158.0118-.1902-.0457-.4855-.5999-1.938-1.7294-3.253-.6076-.7073-1.4896-1.4972-2.6889-2.0395.5251-.1066 1.2328-.2035 2.0244-.1859 2.0515.0456 3.6746.8135 4.8242 2.2824a.908.908 0 0 1 .0667.1002c.7231 1.3556-.2762 6.2751-2.9867 10.5405zm-8.8166-6.1162c-.025.1794-.3089.4225-.6211.4225a.5821.5821 0 0 1-.0809-.0056c-.1873-.026-.3765-.144-.5059-.3156-.0458-.0605-.1203-.178-.1055-.2844.0055-.0401.0261-.0985.0925-.1488.1182-.0894.3518-.1226.6096-.0867.3163.0441.6426.1938.6113.4186zm7.9305-.4114c.0111.0792-.049.201-.1531.3102-.0683.0717-.212.1961-.4079.2232a.5456.5456 0 0 1-.075.0052c-.2935 0-.5414-.2344-.5607-.3717-.024-.1765.2641-.3106.5611-.352.297-.0414.6111.0088.6356.1851z","PostgreSQL","postgresql","Includes database integration capabilities with environment variable support for PostgreSQL connection configuration in production environments.","piukp4642y",{"_54":93,"_31":96,"_62":97},{"_56":94,"_37":95,"_59":95},"M12 0c-.563 0-1.127.215-1.557.645L.645 10.443c-.86.86-.86 2.254 0 3.114l9.798 9.798c.86.86 2.254.86 3.114 0l9.798-9.798c.86-.86.86-2.254 0-3.114L13.557.645A2.195 2.195 0 0012 0zm0 1.74c.493 0 .987.186 1.361.56L21.7 10.64c.75.75.75 1.973 0 2.722L13.361 21.7c-.374.375-.868.56-1.361.56s-.987-.185-1.361-.56L2.3 13.361a1.93 1.93 0 010-2.722L10.639 2.3c.374-.375.868-.56 1.361-.56zm0 .62c-.333 0-.664.127-.92.382L2.742 11.08a1.295 1.295 0 000 1.84l8.338 8.338a1.296 1.296 0 001.84 0l8.338-8.338a1.295 1.295 0 000-1.84L12.92 2.742A1.296 1.296 0 0012 2.36zM9.207 7.624h3.959c.55 0 1.015.079 1.4.238.385.16.7.371.942.633.241.262.417.561.527.897a3.34 3.34 0 010 2.084c-.11.34-.286.64-.527.902a2.628 2.628 0 01-.942.633c-.385.16-.85.238-1.4.238h-2.043v3.156H9.207zm1.916 1.484v2.657h1.514c.222 0 .434-.016.64-.05.207-.032.39-.097.547-.193.158-.095.284-.23.38-.404.094-.174.142-.401.142-.682 0-.28-.048-.507-.143-.681a1.053 1.053 0 00-.379-.404 1.513 1.513 0 00-.547-.194 4.056 4.056 0 00-.64-.049z","pre-commit","Utilizes pre-commit hooks for development workflow automation, ensuring code quality checks before committing changes.","h12edpy7vj",{"_54":99,"_31":103,"_62":104},{"_56":100,"_37":101,"_59":102},"m23.826 17.316-4.23-5.866-6.847-9.496c-.348-.48-1.151-.48-1.497 0l-6.845 9.494-4.233 5.868a.925.925 0 0 0 .46 1.417l11.078 3.626h.002a.92.92 0 0 0 .572 0h.002l11.077-3.626c.28-.092.5-.31.59-.592a.916.916 0 0 0-.13-.825h.002ZM12.001 4.07l4.44 6.158-4.152-1.36c-.032-.01-.066-.008-.098-.016a.8.8 0 0 0-.096-.016c-.032-.004-.062-.016-.094-.016s-.062.012-.094.016a.74.74 0 0 0-.096.016c-.032.006-.066.006-.096.016L7.59 10.221l-.026.008 4.44-6.158h-.002Zm-6.273 8.7 4.834-1.583.516-.168v9.19L2.41 17.372l3.317-4.6Zm7.197 7.437V11.02l5.35 1.752 3.316 4.598-8.666 2.838Z","Pydantic","pydantic","Leverages Pydantic for data validation, settings management, and model definitions within the MCP server.","ece1v8pnhp",{"_54":106,"_31":110,"_62":111},{"_56":107,"_37":108,"_59":109},"M2.6152 0v.8867h3.8399V0zm5.0215 0v.8867h3.8418V0zm4.957 0v.8867h3.8418V0zm4.9356 0v.8867h3.8418V0zM2.4473 1.8945a.935.935 0 0 0-.9356.9356c0 .517.4185.9375.9356.9375h19.1054c.5171 0 .9356-.4204.9356-.9375a.935.935 0 0 0-.9356-.9356zm.168 2.8477V24H6.455V4.7422zm5.0214 0V20.543h3.8418V4.7422zm4.957 0V15.291h3.8497V4.7422zm4.9356 0v6.4941h3.8418V4.7422z","Pytest","pytest","Provides comprehensive test coverage with pytest, including unit tests, integration tests, coverage reporting, and specialized test configurations.","wk6p2x2lcf",{"_54":113,"_31":117,"_62":118},{"_56":114,"_37":115,"_59":116},"M14.044 0c.243 0 .486.202.486.486v5.423l3.804-3.845c.202-.202.526-.202.688 0l2.914 2.914c.162.162.202.486 0 .648v.04L18.09 9.47h5.423c.284 0 .486.203.486.486v4.088a.468.468 0 0 1-.486.486h-5.423l3.845 3.804c.162.202.202.526 0 .688l-2.914 2.914c-.162.162-.486.202-.648 0h-.04L14.53 18.09v5.423a.468.468 0 0 1-.486.486H9.956a.468.468 0 0 1-.486-.486v-2.833c0-.89.365-1.74.972-2.388l5.261-5.261a1.466 1.466 0 0 0 0-2.064l-5.22-5.221A3.4 3.4 0 0 1 9.47 3.359V.486c0-.284.203-.486.486-.486h4.088ZM5.585 2.105h.04l8.864 8.863a1.466 1.466 0 0 1 0 2.064l-8.863 8.904c-.162.202-.486.202-.688 0l-2.874-2.833c-.162-.203-.202-.486 0-.688L5.91 14.53H.486A.468.468 0 0 1 0 14.043V9.956c0-.283.202-.486.486-.486h5.423L2.064 5.666a.548.548 0 0 1 0-.688l2.874-2.873a.421.421 0 0 1 .647 0Z","Scalar","scalar","Integrates Scalar for beautiful and interactive API documentation, enhancing the standard FastAPI documentation capabilities.","8e666qs95f","namespace",{"_121":122,"_59":126},"owner",{"_123":124},"githubAccount",{"_125":126},"login","joonheeu","readmeMarkdown","redditPostExternalId","repository",{"_131":132,"_168":169,"_172":173,"_191":-5,"_192":193,"_194":-5,"_195":-5},"argumentsJsonSchema",{"_133":134,"_165":166,"_140":167},"properties",{"_135":136,"_142":143,"_146":147,"_150":151,"_154":155,"_157":158,"_161":162},"DEBUG",{"_137":138,"_31":139,"_140":141},"default","false","Enable debug mode","type","string","APP_NAME",{"_137":144,"_31":145,"_140":141},"My Awesome API","Name of the application","LOG_FILE",{"_137":148,"_31":149,"_140":141},"logs/app.log","Path to log file","LOG_LEVEL",{"_137":152,"_31":153,"_140":141},"INFO","Logging level","SECRET_KEY",{"_31":156,"_140":141},"Secure random key for the application","ENVIRONMENT",{"_137":159,"_31":160,"_140":141},"development","Application environment (development, production, test)","CORS_ORIGINS",{"_137":163,"_31":164,"_140":141},"http://localhost:3000,http://localhost:8080","Comma-separated list of allowed CORS origins","required",[],"object","githubProject",{"_35":36,"_170":171},"url","https://github.com/joonheeu/fastapi-mcp-template","githubRepository",{"_174":175,"_176":177,"_178":179,"_16":180,"_181":182,"_37":183,"_121":184,"_186":187,"_188":-5,"_189":190},"defaultBranch","main","fullName","joonheeu/fastapi-mcp-template","githubTreeId",318092,17039,"language","Python","fastapi-mcp-template",{"_125":126,"_62":185},"PmmHAVf3xh","recentStargazers",0,"spdxLicense","stargazers",1,"glamaJson","inspectable",false,"npmPackage","supportedPlatforms","scores",{"_198":-5,"_199":-5,"_200":-5},"license","quality","security","simpleIcon","toolCount","eiys62j65e","updatedAt","2025-10-01T19:22:57.813351Z","meta",[208,211,213,220,223,225,228,231,234,237,240,242,245,248,250,252,254,256,258],{"_209":210},"title","FastAPI MCP Template | Glama",{"_212":32,"_37":31},"content",{"_214":215,"_216":217,"_218":219},"href","https://glama.ai/mcp/servers/@joonheeu/fastapi-mcp-template","rel","canonical","tagName","link",{"_212":34,"_221":222},"property","og:title",{"_212":32,"_221":224},"og:description",{"_212":226,"_221":227},"https://glama.ai/logo.png","og:logo",{"_212":229,"_221":230},"https://glama.ai/mcp/servers/@joonheeu/fastapi-mcp-template/og-image","og:image",{"_212":232,"_221":233},"630","og:image:height",{"_212":235,"_221":236},"1200","og:image:width",{"_212":238,"_221":239},"website","og:type",{"_212":215,"_221":241},"og:url",{"_212":243,"_221":244},"Glama – MCP Hosting Platform","og:site_name",{"_212":246,"_37":247},"summary_large_image","twitter:card",{"_212":243,"_37":249},"twitter:title",{"_212":32,"_37":251},"twitter:description",{"_212":229,"_37":253},"twitter:image",{"_212":232,"_37":255},"twitter:image:height",{"_212":235,"_37":257},"twitter:image:width",{"_259":260},"script:ld+json",{"_261":262,"_263":264},"@context","http://schema.org","@graph",[265],{"_261":266,"_267":268,"_269":270},"https://schema.org","@type","BreadcrumbList","itemListElement",[271,277,281,285],{"_267":272,"_273":274,"_37":275,"_276":190},"ListItem","item","/","Glama","position",{"_267":272,"_273":278,"_37":279,"_276":280},"/mcp","MCP",2,{"_267":272,"_273":282,"_37":283,"_276":284},"/mcp/servers","Servers",3,{"_267":272,"_273":286,"_37":34,"_276":287},"/mcp/servers/@joonheeu/fastapi-mcp-template",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_291":292,"_29":298,"_337":338,"_206":352,"_349":376,"_377":378},"blob",{"_212":293,"_294":295,"_296":297},"\"\"\"\nMCP (Model Context Protocol) server implementation.\n\"\"\"\n\nfrom .server import create_mcp_server\nfrom .tools import *\nfrom .resources import * ","fileName","__init__.py","size",145,{"_42":43,"_13":299,"_48":32,"_49":32,"_33":34,"_16":50,"_51":300,"_119":319,"_127":-5,"_128":-5,"_129":322,"_196":336,"_201":-5,"_59":183,"_202":187,"_62":203,"_204":205},[45,46,47],[301,303,305,307,309,311,313,315,317],{"_54":302,"_31":61,"_62":63},{"_56":57,"_37":58,"_59":60},{"_54":304,"_31":69,"_62":70},{"_56":66,"_37":67,"_59":68},{"_54":306,"_31":76,"_62":77},{"_56":73,"_37":74,"_59":75},{"_54":308,"_31":83,"_62":84},{"_56":80,"_37":81,"_59":82},{"_54":310,"_31":90,"_62":91},{"_56":87,"_37":88,"_59":89},{"_54":312,"_31":96,"_62":97},{"_56":94,"_37":95,"_59":95},{"_54":314,"_31":103,"_62":104},{"_56":100,"_37":101,"_59":102},{"_54":316,"_31":110,"_62":111},{"_56":107,"_37":108,"_59":109},{"_54":318,"_31":117,"_62":118},{"_56":114,"_37":115,"_59":116},{"_121":320,"_59":126},{"_123":321},{"_125":126},{"_131":323,"_168":333,"_172":334,"_191":-5,"_192":193,"_194":-5,"_195":-5},{"_133":324,"_165":332,"_140":167},{"_135":325,"_142":326,"_146":327,"_150":328,"_154":329,"_157":330,"_161":331},{"_137":138,"_31":139,"_140":141},{"_137":144,"_31":145,"_140":141},{"_137":148,"_31":149,"_140":141},{"_137":152,"_31":153,"_140":141},{"_31":156,"_140":141},{"_137":159,"_31":160,"_140":141},{"_137":163,"_31":164,"_140":141},[],{"_35":36,"_170":171},{"_174":175,"_176":177,"_178":179,"_16":180,"_181":182,"_37":183,"_121":335,"_186":187,"_188":-5,"_189":190},{"_125":126,"_62":185},{"_198":-5,"_199":-5,"_200":-5},"member",{"_339":340,"_343":344,"_345":346,"_178":347,"_348":193,"_349":295,"_350":351,"_296":297,"_140":291},"commit",{"_341":342},"sha","060de368c3aa251ffc7baf14a374a77496c580eb","contentStoredObjectPointerId",324318,"fullPath","src/mcp_server/__init__.py",318088,"indexable","path","safeToDisplayAsText",true,[353,355,357,359,361,362,363,365,366,367,368,369,370,371,372,373,374,375],{"_209":354},"__init__.py | FastAPI MCP Template | Glama",{"_212":356,"_37":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_214":358,"_216":217,"_218":219},"https://glama.ai/mcp/servers/@joonheeu/fastapi-mcp-template/blob/060de368c3aa251ffc7baf14a374a77496c580eb/src/mcp_server",{"_212":360,"_221":222},"__init__.py | FastAPI MCP Template",{"_212":356,"_221":224},{"_212":226,"_221":227},{"_212":364,"_221":230},"https://glama.ai/generated-images/og?title=__init__.py+%7C+FastAPI+MCP+Template",{"_212":232,"_221":233},{"_212":235,"_221":236},{"_212":238,"_221":239},{"_212":358,"_221":241},{"_212":243,"_221":244},{"_212":246,"_37":247},{"_212":243,"_37":249},{"_212":356,"_37":251},{"_212":364,"_37":253},{"_212":232,"_37":255},{"_212":235,"_37":257},"src/mcp_server","treeMembers",[379,381,385,389],{"_339":380,"_345":346,"_349":295,"_140":291},{"_341":342},{"_339":382,"_345":383,"_349":384,"_140":291},{"_341":342},"src/mcp_server/resources.py","resources.py",{"_339":386,"_345":387,"_349":388,"_140":291},{"_341":342},"src/mcp_server/server.py","server.py",{"_339":390,"_345":391,"_349":392,"_140":291},{"_341":342},"src/mcp_server/tools.py","tools.py","actionData","errors"]

MCP directory API