fantsec-http-mcp-wrapper

一个极薄的本地 MCP wrapper。

它的作用不是实现 MCP 协议，而是把本地客户端配置里的 env 转成远程 HTTP MCP 所需的 Authorization: Bearer ... 请求头，然后复用 mcp-remote 完成 stdio <-> 远程 HTTP MCP 的桥接。

适用场景：

• 远程 MCP 已部署在服务端
• 用户希望在 Cursor / VS Code / Claude / Codex 的 MCP 配置里直接写 env
• 不希望依赖系统全局环境变量或 .bashrc

安装方式

推荐通过 GitHub tag 使用：

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": [
        "github:youngwawapro/http-mcp-wrapper#v0.1.0",
        "--url",
        "https://mcp.fantsec.com/plane/mcp",
        "--bearer-env-var",
        "MCP_PLANE_TOKEN"
      ],
      "env": {
        "MCP_PLANE_TOKEN": "plane_api_xxx"
      }
    }
  }
}

Docmost 示例：

{
  "mcpServers": {
    "docmost": {
      "command": "npx",
      "args": [
        "github:youngwawapro/http-mcp-wrapper#v0.1.0",
        "--url",
        "https://mcp.fantsec.com/docmost/mcp",
        "--bearer-env-var",
        "MCP_DOCMOST_TOKEN"
      ],
      "env": {
        "MCP_DOCMOST_TOKEN": "[email protected]:your_password"
      }
    }
  }
}

参数

• --url <url>：远程 MCP 地址，必填
• --bearer-env-var <name>：Bearer token 所在的环境变量名，默认 MCP_BEARER_TOKEN
• --header <name:value>：额外透传给 mcp-remote 的 header，可重复
• 其他参数：全部原样转发给 mcp-remote

例如：

fantsec-http-mcp-wrapper \
  --url https://mcp.fantsec.com/plane/mcp \
  --bearer-env-var MCP_PLANE_TOKEN \
  --debug

更新方式

建议固定 tag，不要直接跟主分支。

例如当前使用：

"github:youngwawapro/http-mcp-wrapper#v0.1.0"

发布新版本后改成：

"github:youngwawapro/http-mcp-wrapper#v0.1.1"

然后重启客户端即可。