Xray Config MCP

一个用于生成 Xray 配置的 MCP Server，支持两种传输方式：

• Streamable HTTP
• stdio

支持的工具

• generate_shadowsocks_2022_psk
• generate_shadowsocks_2022_config
• generate_vless_preset_config
  • vless_tcp_reality_vision
  • vless_xhttp_reality
  • vless_encryption_tls

以上生成配置类工具会同时返回：

• share_link：主共享链接
• share_links：多个兼容变体（数组，含名称和链接）

Shadowsocks 2022 共享链接格式： ss://base64(method:ServerPassword:UserPassword)@address:port#remark （single 模式为 method:password；默认 remark 为 xray-ss2022，可通过 remark 参数覆盖）

快速开始

cd mcp
npm install

1) HTTP 模式

启动：

npm start

默认地址：http://127.0.0.1:8787/mcp

可自定义：

npx xray-config-mcp --transport http --host 0.0.0.0 --port 8787 --path /mcp

客户端请求头建议：

• Accept: application/json, text/event-stream
• Content-Type: application/json（POST）

2) stdio 模式

启动：

npm run start:stdio

或：

npx xray-config-mcp --transport stdio

在 MCP 客户端中可按“命令启动”方式接入，例如：

{
  "command": "npx",
  "args": ["xray-config-mcp", "--transport", "stdio"]
}

调用示例

{
  "name": "generate_vless_preset_config",
  "arguments": {
    "preset": "vless_tcp_reality_vision",
    "server_host": "example.com",
    "server_port": 443,
    "uuid": "REPLACE_WITH_UUID",
    "reality_server_name": "www.cloudflare.com",
    "reality_dest": "www.cloudflare.com:443",
    "short_id": "a1b2c3d4"
  }
}

将 preset 改为 vless_xhttp_reality 或 vless_encryption_tls 可生成其他模板。

说明

• 对于 Reality 预设：
  • 若不传 reality_private_key 和 reality_public_key，会自动生成 X25519 密钥对。
  • 若手动传入，必须同时提供这两个字段。
• 生成结果建议在实际部署前使用 xray run -test -config <path> 做校验。