Provides location-based recommendations for food, activities, accommodations, and attractions using the Google Gemini model.
Integrates with Kakao Local API to provide location-based recommendations for food, activities, accommodations, and attractions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-service calculate 15% of 200"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP(Model Context Protocol) 도구를 WebSocket으로 서빙하는 3계층 릴레이 서비스입니다.
[소비자] ──WS /call/──▶ [서버] ──WS /mcp/──▶ [파이프] ──stdio──▶ [도구]계층 | 역할 | 진입점 |
서버 | FastAPI WebSocket 릴레이, JSON-RPC ID 변환 |
|
파이프 | stdio ↔ WebSocket 양방향 연결, 자동 재연결 |
|
도구 | FastMCP 앱 (calculator, scripture, what_to_do) | subprocess (파이프가 자동 실행) |
Related MCP server: Basic MCP Server
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt.env 파일을 프로젝트 루트에 생성:
# 필수
MCP_SERVER_KEY=<서버/파이프가 공유하는 AES 키>
MCP_ENDPOINT=ws://localhost:2080/mcp_endpoint/mcp/
# 도구 사용 시 필요
GEMINI_API_KEY=your_gemini_api_key
KAKAO_API_KEY=your_kakao_api_key통합 설치에서는 루트
.env의MCP_SERVER_KEY를 사용합니다. 단독 실행 시main.py가 로컬.env를 생성하고 누락 값을 안내합니다.
# 기본 모드: 서버와 파이프 동시 실행
python main.py
# 개별 실행
python main.py server # 서버만 실행
python main.py pipe # 파이프만 실행mcp-service.cfg로 서버 동작을 제어합니다. 민감한 키는 .env/환경변수에서 관리합니다.
[server]
host = 0.0.0.0
port = 2080
log_level = INFO
[websocket]
max_connections = 1000
ping_interval = 30
ping_timeout = 10
[security]
allowed_origins = *
enable_cors = true상세 계약은 루트 문서 ../docs/mcp/interface-contract.md를 기준으로 확인합니다.
엔드포인트 | 설명 |
| 루트 |
| 서버 상태 |
| 헬스 체크 |
| 파이프 연결 |
| 소비자 연결 |
토큰은 MCP_SERVER_KEY로 AES 암호화된 JSON 페이로드입니다. 현재 코드 기준 페이로드는 {"agentId": "<name>"} 형식입니다.
mcp_config.json에 등록된 도구를 파이프가 자동으로 subprocess로 실행합니다.
도구 | 설명 |
| Python 수식 계산 ( |
| 종교 구절 목록 조회 ( |
|
|
| 위치 기반 음식/활동/숙박/관광 추천 (Gemini + Kakao) |
새 도구 추가 절차는 ../docs/mcp/adding-tools.md를 따른다.
변수 | 필수 | 설명 |
| 파이프 필수 | AES 암호화 키 (서버 최초 실행 시 자동 생성) |
| 파이프 필수 | 서버 WebSocket 주소 |
| 선택 | 서버 공개 호스트 오버라이드 |
| 선택 | mcp_config.json 커스텀 경로 |
| 도구 필수 | Google Gemini API 키 |
| 선택 | Gemini 모델명 (기본: |
| 선택 | Kakao 로컬 API 키 |
pytest tests/ -v서버 / 도구 / 파이프 / 유틸 계층 테스트를 포함한다.
This server cannot be deployed
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
The official Planning Center MCP server for interacting with your ministry's data.
Free, no-key Bible MCP server — 86 translations in 32 languages, from any MCP client.
Build, deploy, and host full-stack web apps from any MCP client. DB, auth, storage, cron included.
