Dummy MCP Server

Dummy MCP Server

本项目是一个使用 FastMCP 框架构建的简单 MCP（Meta-agent Communication Protocol）服务。服务通过 SSE（Server-Sent Events）进行通信，并提供 echo 工具和 dummy 工具。

主要技术栈

• FastAPI：Web 框架（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 端点：输入以下 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 流的默认路径。
   • 身份验证：当前 dummy-mcp-server 不使用身份验证，因此请设置为“None”。
   • 要包含的工具：设置为“All”，或根据需要选择特定工具。

Python 依赖项（requirements.txt）

以下是主要依赖项列表（完整列表请参阅 requirements.txt 文件）：

fastmcp==1.0.0
httpx>=0.27.0
uvicorn
numpy
fastapi==0.109.2
# python-dotenv (주석 처리됨)
# ... 기타 mcp 및 fastapi 의존성

提供的工具

服务在 app/main.py 中注册并提供以下两个工具。

1. dummy 工具

   • 源文件：app/tools/dummy.py
   • 说明：一个简单的同步工具，会将收到的字符串消息输出到控制台，并返回成功状态及收到的消息。
   • 输入参数：
     • message (str)：dummy 工具接收的字符串。
   • 返回：{\"status\": \"success\", \"tool_message\": \"Dummy tool received: [输入的消息]\"}

2. echo 工具

   • 源文件：app/tools/echo.py
   • 说明：用于演示 SSE 流式传输功能的示例工具。它会重复输出输入的消息 3 次，每条消息之间间隔 1 秒，并通过 SSE 流返回。
   • 输入参数：
     • message (str)：要回显的字符串。
   • 返回：流式响应后返回 {\"status\": \"Echo stream completed\"}。

MCP 服务信息

• 名称：Dummy MCP Server
• 说明：FastMCP 1.0.0 with SSE, echo tool, and dummy tool.
• 主机：0.0.0.0（Docker 容器内部）
• 端口：8002（Docker 内外使用相同端口映射）
• 通信方式：SSE（Server-Sent Events）——使用默认端点 /sse。