AI导哈

MCP通信协议服务器

基于FastMCP框架构建的MCP服务器，通过SSE提供echo和dummy工具，适用于需要轻量级通信协议的开发场景。

  • by restful3
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 restful3/dummy_mcp_server

使用说明

虚拟MCP服务器

这个项目 FastMCP 使用框架构建的简单的元代理通信协议（MCP）服务器。服务器通过Server-Sent Events（SSE）进行通信。 echo 工具和 dummy 提供工具。

关键技术堆栈

  • 快速 API：Web框架（FastMCP的基础）
  • 乌维科恩：ASGI服务器（运行FastAPI应用程序）
  • FastMCP：构建MCP服务器的框架（版本1.0.0）
  • Docker&Docker编写：容器化和服务管理
  • 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 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）：堆叠工具要接收的字符串。
    • 返还: {\"status\": \"success\", \"tool_message\": \"Dummy tool received: [입력된 메시지]\"}

  2. echo 工具

    • 源文件: app/tools/echo.py
    • 说明：演示SSE流媒体功能的示例工具。重复输入的消息3次，并在每条消息之间留出1秒的延迟，返回SSE流。
    • 输入参数:
      • message （str）：要回声的字符串。
    • 返还：流响应后 {\"status\": \"Echo stream completed\"}返回。

关于MCP服务器

  • 姓名：虚拟MCP服务器
  • 说明：FastMCP 1.0.0，带SSE、回声工具和虚拟工具。
  • 主机: 0.0.0.0 （在Docker容器中）
  • 端口: 8002 （映射Docker外部和内部的相同端口）
  • 通信方式：服务器-发送事件（SSE）-基本端点 /sse 使用。

相关 MCP