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

MCP Server.exe 是一个강력한 可执行服务器,它不仅能够运行标准的 MCP (Model Context Protocol) 서비스,更提供了丰富的高级기능:

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

MCP Server.exe은 표준 MCP(모델 컨텍스트 프로토콜) 서비스를 실행할 뿐만 아니라 풍부하고 고급 기능도 제공하는 강력한 실행 서버입니다:

• 툴 체인 실행: 복잡한 자동화를 위한 여러 도구의 순차적 조합 지원
• 다중 MCP 서비스: 여러 MCP 서비스를 동시에 실행 및 관리할 수 있으며, SSE와 stdio 모드를 모두 지원합니다
• 플러그인 툴 시스템: 맞춤형 도구의 동적 로딩 및 구성 지원
• 유연한 배포: 독립 실행부터 분산 배포까지 다양한 통합 시나리오 충족
• 설정 변경 시 자동 재로드

사용

🎯 主要使用场景 | 주요 사용 시나리오

1. WebSocket 연결 모드 | WebSocket 연결 모드

지지通过 WebSocket 连接到다른 MCP 서비스,特别适合连接到 xiaozhi.me 等的接入. 通过配置文件,可以轻松地将多个 MCP 서비스接入到 xiaozhi.me.

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