mcp_server.exe

Cursor 的 MCP 启动器 - MCP For Cursor

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

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

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

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

The simplest way - double-click to run, and start a standard MCP service.

# 双击运行 mcp_server.exe，或通过命令行启动
# Double-click mcp_server.exe, or start via command line:
./mcp_server.exe

默认配置 | Default Configuration:

• 监听端口 | Listen Port: 3000
• 支持标准端点 | Standard Endpoints: /mcp, /sse, /messages
• 内置基础工具集 | Built-in Basic Tools

使用和 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. This allows you to choose the appropriate transport method for different application scenarios, improving system flexibility and scalability.

./mcp_server.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"]
      }
    }
}

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

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

./mcp_server.exe --mcp-config ./examples/product-hunt/mcp-tool.json

配置示例 | Configuration Example (tool-chain.json):

{
    "toolChains": {
        "browser_automation": {
            "name": "browser_automation",
            "description": "自动化浏览器操作流程 | Automated browser operation process",
            "steps": [
                {
                    "toolName": "browser_navigate",
                    "args": {
                        "url": "https://example.com"
                    }
                },
                {
                    "toolName": "browser_execute_javascript",
                    "args": {
                        "code": "document.title"
                    },
                    "outputMapping": {
                        "selector": "content.0.text"
                    }
                },
                {
                    "toolName": "browser_close",
                    "args": {},
                    "fromStep": 0
                }
            ],
            "output": {
                "steps": [1]  // 只输出第二步的结果
            }
        }
    }
}

工具链特性 | Tool Chain Features:

• 支持多步骤顺序执行 | Support multi-step sequential execution
• 灵活的数据流转映射 | Flexible data flow mapping
• 可从任意步骤获取结果 | Can get results from any step
• 自定义输出步骤结果 | Customize output step results

通过 JavaScript 配置文件，灵活定义工具、资源和提示。

Flexibly define tools, resources, and prompts through JavaScript configuration files.

./mcp_server.exe --mcp-js ./my-custom-tools.js

配置示例 | Configuration Example (my-custom-tools.js):

module.exports = {
  configureMcp: function(server, ResourceTemplate, z) {
    // 添加自定义工具 | Add custom tool
    server.tool({
      name: "myTool",
      description: "自定义工具示例 | Custom tool example",
      parameters: {
        // ... 参数定义 | Parameter definitions
      }
    });
    
    // 添加自定义资源 | Add custom resource
    server.resource(/* ... */);
  }
}

作为独立进程集成到任何应用程序中。

Integrate as a standalone process into any application.

// Node.js 示例 | Node.js Example
const { spawn } = require('child_process');

const mcpServer = spawn('./mcp_server.exe', [
  '--port', '3000',
  '--transport', 'stdio'  // 使用 stdio 模式进行进程间通信 | Use stdio mode for IPC
]);

// 处理输入输出 | Handle I/O
mcpServer.stdout.on('data', (data) => {
  // 处理 MCP 服务器的输出 | Handle MCP server output
});

mcpServer.stdin.write(JSON.stringify({
  // 发送请求到 MCP 服务器 | Send request to MCP server
}));

服务器支持以下命令行参数来自定义其行为：

The server supports the following command line arguments to customize its behavior:

服务器支持使用配置文件同时配置服务器参数和 MCP 功能：

The server supports using a configuration file to configure both server parameters and MCP functionality:

module.exports = {
  
  // MCP 配置函数 | MCP configuration function
  configureMcp: function(server, ResourceTemplate, z) {
    // 配置资源和工具 | Configure resources and tools
  }
};

npm install

npm run build

npm start
# 或开发模式 | Or development mode
npm run dev

# 为 Windows 打包 | Package for Windows
npm run package-win

# 为 macOS 打包 | Package for macOS
npm run package-mac

打包后的可执行文件将生成在 executables 目录中。

The packaged executable files will be generated in the executables directory.

• PORT - 服务器端口号（默认：3000）| Server port (default: 3000)

MIT