Dummy MCP Server
About
A simple MCP (Meta-agent Communication Protocol) server built with the FastMCP 1.0.0 framework. It communicates via Server-Sent Events (SSE) and provides two tools: an echo tool (streaming) and a dummy tool (synchronous). Designed for integration with n8n workflows through its…
Details
- Author
- restful3
- Downloads
- 459
- Categories
- Other
Jump to
Clone the repository and run docker-compose up --build -d to start the server on port 8002. In n
Dummy MCP Server
이 프로젝트는 FastMCP 프레임워크를 사용하여 구축된 간단한 MCP (Meta-agent Communication Protocol) 서버입니다. 서버는 SSE (Server-Sent Events)를 통해 통신하며, echo 도구와 dummy 도구를 제공합니다.
주요 기술 스택
FastAPI: 웹 프레임워크 (FastMCP의 기반)
Uvicorn: ASGI 서버 (FastAPI 애플리케이션 실행)
FastMCP: MCP 서버 구축을 위한 프레임워크 (버전 1.0.0)
Docker & Docker Compose: 컨테이너화 및 서비스 관리
Python: 주 개발 언어
프로젝트 구조
.dummy_mcp_server/
├── app/
│ ├── __init__.py
│ ├── main.py # FastAPI 애플리케이션 및 MCP 서버 설정, 도구 등록
│ └── tools/
│ ├── __init__.py
│ ├── dummy.py # 'dummy' 도구 구현
│ └── echo.py # 'echo' 도구 구현
├── docker-compose.yml # Docker Compose 설정 파일
├── README.md # 이 파일
└── requirements.txt # Python 의존성 목록
설정 및 실행
요구 사항
Docker
Docker Compose
로컬 실행 (Docker Compose 사용)
1. 저장소 클론 (이미 로컬에 있는 경우 생략)
2. Docker 이미지 빌드 및 컨테이너 실행:
프로젝트 루트 디렉토리에서 다음 명령을 실행합니다. 이 명령은 필요시 이미지를 빌드하고 백그라운드에서 컨테이너를 시작합니다.
docker-compose up --build -d
서버는 Docker 컨테이너 내부의 0.0.0.0:8002
에서 실행되며, docker-compose.yml 설정에 따라 호스트 머신의 http://localhost:8002 (또는 Docker 호스트 IP의 8002 포트)로 노출됩니다.
3. 로그 확인:\
docker-compose logs -f dummy_mcp_server
4. 서버 중지:\
docker-compose down
n8n 연동 가이드
dummy-mcp-server를 n8n 워크플로우와 연동하려면 다음 단계를 따르십시오.
1. Docker 네트워크:
dummy-mcp-server 컨테이너와 n8n 컨테이너가 동일한 Docker 네트워크 환경에서 실행되고 있어야 서로 통신할 수 있습니다.
현재 docker-compose.yml은 dummy-mcp-server 서비스를 생성하며, 별도의 네트워크를 명시하지 않으면 Docker Compose가 생성하는 기본 네트워크에 연결됩니다. n8n 컨테이너도 이 네트워크에 연결되어 있거나, 또는 두 컨테이너가 공유하는 외부 네트워크(예: nginx-n8n-net)에 함께 연결되어 있어야 합니다.
만약 n8n과 dummy-mcp-server가 동일한 docker-compose.yml 파일 내에서 서비스로 정의되어 있다면, Docker Compose가 자동으로 같은 네트워크에 배치하므로 서비스 이름(컨테이너 이름)으로 서로를 찾을 수 있습니다.
2. n8n MCP Client 노드 설정:
n8n 워크플로우에서 "MCP Client" 노드를 추가합니다.
SSE Endpoint: 다음 URL을 입력합니다.
http://dummy-mcp-server:8002/sse
dummy-mcp-server: docker-compose.yml에 정의된 서비스 이름입니다. Docker 내부 DNS가 이 이름을 dummy-mcp-server 컨테이너의 IP로 해석합니다. (만약 n8n이 Docker 외부에서 실행되고 dummy-mcp-server만 Docker로 실행 중이라면, localhost 또는 Docker 호스트의 IP를 사용해야 합니다: http://localhost:8002/sse)
8002: dummy-mcp-server가 리스닝하는 포트입니다.
/sse: FastMCP 라이브러리가 SSE 스트림을 위해 사용하는 기본 경로입니다.
Authentication: 현재 dummy-mcp-server는 인증을 사용하지 않으므로 "None"으로 설정합니다.
* Tools to Include: "All"로 설정하거나 필요에 따라 특정 도구만 선택할 수 있습니다.
Python 의존성 (
requirements.txt)
다음은 주요 의존성 목록입니다 (전체 목록은
requirements.txt 파일 참조):
``fastmcp==1.0.0
httpx>=0.27.0
uvicorn
numpy
fastapi==0.109.2
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



