plugin-mcp

@xrxs-plugin/plugin-mcp 是一个可通过 npx 直接启动的本地 MCP bridge。

它用于把本地 IDE 中的 stdio MCP 调用桥接到远程 plugin-mcp 服务，并以标准 MCP Server 的方式提供给 Trae、Claude Code、Codex 等支持 MCP 的开发工具使用。

它能做什么

1. 通过标准输入输出暴露本地 MCP Server
2. 将本地工具调用转发到远程 plugin-mcp 服务
3. 自动补齐统一请求头
4. 通过 npx 直接启动，无需全局安装

环境要求

1. Node.js 18+
2. 可访问的远程 plugin-mcp 服务

安装与使用

推荐直接通过 npx 启动：

npx -y @xrxs-plugin/plugin-mcp@latest

环境变量

以下环境变量均为可选：

• MCP_BASE_URL
  • 远程 plugin-mcp 服务地址
  • 默认值：https://mcp.xinrenxinshi.com/plugin-mcp/bridge
• MCP_OPENHANDS_BASE_URL
  • OpenHands 相关接口地址；当 compileCheck、deployPlugin、getCompileLog 等工具走 /openhands/service/* 时使用
  • 默认值：https://mcp.xinrenxinshi.com/plugin-mcp/bridge
• MCP_DEV_KEY
  • 访问远程服务所需的开发密钥
  • 默认值：xrxs-dev-1c9c00e6331c417f
• MCP_TIMEOUT_SECONDS
  • 远程请求超时时间，单位秒
  • 默认值：30

说明：

• MCP_TIMEOUT_SECONDS 必须是大于 0 的整数
• 默认情况下，MCP_BASE_URL 与 MCP_OPENHANDS_BASE_URL 可以保持一致
• 生产或团队环境中，建议通过外部配置覆盖默认值

Trae 配置示例

最简配置：

{
  "mcpServers": {
    "xrxs-plugin-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xrxs-plugin/plugin-mcp@latest"
      ]
    }
  }
}

自定义环境变量：

{
  "mcpServers": {
    "xrxs-plugin-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xrxs-plugin/plugin-mcp@latest"
      ],
      "env": {
        "MCP_BASE_URL": "https://mcp.xinrenxinshi.com/plugin-mcp/bridge",
        "MCP_OPENHANDS_BASE_URL": "https://mcp.xinrenxinshi.com/plugin-mcp/bridge",
        "MCP_DEV_KEY": "your-dev-key",
        "MCP_TIMEOUT_SECONDS": "30"
      }
    }
  }
}

注意：

• 如果使用 mcp.xinrenxinshi.com/plugin-mcp/bridge，请优先使用 https
• 当前公网网关在 http 请求下会返回 302 到站点根路径，导致部分接口最终拿到纯文本 ok，从而表现为工具调用异常

支持的工具

当前 bridge 提供以下能力分组：

1. 服务连接

• plugin_mcp_health
• plugin_mcp_initialize

2. 项目初始化

• plugin_mcp_implementation_project_init

3. 支持工单

• plugin_mcp_support_ticket_create
• plugin_mcp_support_ticket_query
• plugin_mcp_support_ticket_update
• plugin_mcp_support_ticket_close
• plugin_mcp_support_ticket_recovery_check

4. 工作流状态

• plugin_mcp_workflow_state_get
• plugin_mcp_workflow_state_update
• plugin_mcp_workflow_block
• plugin_mcp_workflow_resume
• plugin_mcp_workflow_history_query

5. 质量与构建

• plugin_mcp_build_static_analysis
• plugin_mcp_build_compile
• plugin_mcp_build_security_scan

6. 发布

• plugin_mcp_release_test_deploy
• plugin_mcp_release_status_get
• plugin_mcp_release_log_query

7. 项目与运行信息

• plugin_mcp_get_project_id_by_project_path
• plugin_mcp_compile_check
• plugin_mcp_get_compile_log
• plugin_mcp_deploy_plugin
• plugin_mcp_get_plugin_info_by_project_id
• plugin_mcp_get_plugin_configs
• plugin_mcp_add_plugin_config
• plugin_mcp_delete_plugin_config
• plugin_mcp_get_plugin_runtime_logs
• plugin_mcp_get_plugin_lifecycle_events

8. 本地辅助工具

• plugin_mcp_util_snowflake_id

使用建议

1. 优先通过 initialize 获取服务能力信息
2. 在同一条业务流程中，建议复用统一的 workflowId
3. 真实执行结果依赖远程服务返回，本地 bridge 不会伪造业务结果
4. 对于敏感配置，建议通过环境变量注入，不要直接写入仓库

本地开发

安装依赖：

npm install

语法检查：

npm run check

本地启动：

npm start

发布

npm login
npm whoami
npm publish

版本升级后发布：

npm version patch
npm publish

License

MIT