MCP Server.exe

小智 & Cursor 的 MCP 启动器 - MCP For Cursor&xiaozhi

MCP Server.exe 是一个强大的可执行服务器，它不仅能够运行标准的 MCP (Model Context Protocol) 服务，更提供了丰富的高级功能：

• 工具链式调用：支持将多个工具按序组合，实现复杂的自动化流程
• 多 MCP 服务组合：可同时运行和管理多个 MCP 服务，支持 SSE 和 stdio 双模式
• 插件化工具系统：支持自定义工具的动态加载和配置
• 灵活的部署选项：从单机运行到分布式部署，满足各类集成场景
• 自动重载：监听 --mcp-config 与 --mcp-js 变更，自动重启生效

MCP Server.exe is a powerful executable server that not only runs standard MCP (Model Context Protocol) services, but also provides rich advanced features:

• Tool Chain Execution: Support sequential combination of multiple tools for complex automation
• Multiple MCP Services: Can run and manage multiple MCP services simultaneously, supporting both SSE and stdio modes
• Pluggable Tool System: Support dynamic loading and configuration of custom tools
• Flexible Deployment: From standalone operation to distributed deployment, meeting various integration scenarios
• Auto reload for config changes

Usage

# 推荐：通过 CLI 运行（无需本地构建）
npx mcp_exe --mcp-config ./examples/mcp.json

# 或运行打包后的可执行文件（Windows/macOS）
./executables/mcp_server-win-x64.exe --mcp-config ./examples/mcp.json

🎯 主要使用场景 | Main Usage Scenarios

1. WebSocket 连接模式 | WebSocket Connection Mode

支持通过 WebSocket 连接到其他 MCP 服务，特别适合连接到 xiaozhi.me 等的接入。通过配置文件，可以轻松地将多个 MCP 服务接入到 xiaozhi.me。

Support connecting to other MCP services via WebSocket, especially suitable for connecting to WebSocket-enabled MCP services like xiaozhi.me. Through configuration files, you can easily integrate multiple MCP services with xiaozhi.me.

# 使用配置文件连接到 xiaozhi.me / Start in WebSocket mode
npx mcp_exe --ws wss://api.xiaozhi.me/mcp/?token=...xxx --mcp-config ./examples/mcp-sse.json

配置示例 | Configuration Example (mcp-sse.json):

{
    "mcpServers": {
        "Model Server sse": {
            "url": "http://127.0.0.1:3000"
        }
    },
    "serverInfo": {
        "serverName": "ws-client-mcp-server",
        "version": "1.0.0",
        "description": "WebSocket 客户端的 MCP 服务器实例",
        "author": "shadow"
    }
}

WebSocket 模式特性 | WebSocket Mode Features:

• 支持实时双向通信 | Support real-time bidirectional communication
• 自动重连机制 | Automatic reconnection mechanism
• 多服务统一管理 | Unified management of multiple services
• 兼容标准 MCP 协议 | Compatible with standard MCP protocol

相关项目可视化xiaozhi-mcp启动器

2. 快速启动独立服务 | Quick Start Standalone Service

最简单的使用方式 - 双击运行，或使用 npx 即可启动一个标准的 MCP 服务。

The simplest way - double-click to run, or start via npx.

# 双击运行 mcp_server.exe，或通过命令行启动
./executables/mcp_server-win-x64.exe
# 或
npx mcp_exe

默认配置 | Default Configuration:

• 监听端口 | Listen Port: 3000（可通过 --port 修改）
• SSE 路由 | SSE Endpoints: GET / 建立会话，POST /sessions?sessionId=... 发送消息
• 内置基础工具集 | Built-in Basic Tools
• 自动重载 | Auto reload --mcp-config 与 --mcp-js

3. 组合多个 MCP 服务 | Combine Multiple MCP Services

使用与 Cursor 一致的 mcp.json 配置文件，通过配置文件组合多个 MCP 服务，支持同时使用 SSE 和 stdio 两种传输模式。这样可以根据不同的应用场景选择合适的传输方式，提高系统的灵活性和可扩展性。

Use the same mcp.json configuration file as Cursor to combine multiple MCP services, supporting both SSE and stdio transport modes simultaneously.

npx mcp_exe --mcp-config ./examples/mcp.json

配置示例 | Configuration Example (mcp.json):

{
  "mcpServers": {
    "Model Server sse": { "url": "http://127.0.0.1:9090" },
    "Model Server - stdio": { "command": "xxx", "args": ["--transport", "stdio"] }
  },
  "serverInfo": { "serverName": "dynamic-mcp-server" },
  "tools": [],
  "namespace": "."
}

• tools: 允许的工具白名单（为空数组表示不过滤）
• namespace: 组合命名空间分隔符，默认 .（亦可使用 ::）

4. 工具链式调用 | Tool Chain Execution

支持将多个工具组合成工具链，实现复杂的自动化流程。工具链可以灵活配置数据流转和结果输出。

Support combining multiple tools into a tool chain to implement complex automation processes. Tool chains can flexibly configure data flow and result output.

npx mcp_exe --mcp-config ./examples/p

... [View full README on GitHub](https://github.com/shadowcz007/mcp_server_exe#readme)