Plumrr MCP Client

PluMRR MCP客户端

LibreChat的独立HTTP/SSE MCP服务器。隔离在 mcp-client 有自己的Dockerfile。

建筑

• 无状态：没有服务器端会话/cookie持久性，没有cookie jar，没有全局变量。
• LibreChat凭据（推荐）：配置MCP headers 在LibreChat中（例如。 X-Plumrr-Email / X-Plumrr-Password).服务器读取这些 每个传入的HTTP请求 到 /mcp，为该请求执行一次上游登录（仅在请求期间缓存在内存中），并将生成的Cookie用于工具调用。LLM确实如此 不 收到您的密码，无需拨打电话 auth_login 第一。
• 手动cookie模式：或者，致电 auth_login 使用电子邮件/密码和密码 cookieHeader 在以后的工具上（或者依赖LibreChat头文件）。
• 允许列出：仅公开已批准的GET端点和身份验证操作。对路径参数进行消毒，防止遍历注入。
• 会话感知：MCP协议会话按照 mcp-session-id 标头（MCP Streamable HTTP规范要求），但在HTTP请求之间没有在服务器端存储PluMRR用户身份验证。

可用工具

认证

合同

客户

平均倒数排名

报告

客户损失

嵌入报告

环境

在本地运行

npm install
npm run dev

服务器终结点：

• 健康： GET /health
• MCP： POST /mcp （初始化+工具调用）， GET /mcp （SSE流）， DELETE /mcp （闭幕式）

码头工人

docker build -t plumrr-mcp-client .
docker run --rm -p 8001:8001 \
  -e PLUMRR_API_BASE_URL=http://host.docker.internal:8000 \
  plumrr-mcp-client

Docker Compose（项目本地）

此项目包含自己的编写文件，位于 mcp-client/docker-compose.yml.

1. 复制环境默认值：

cp .env.example .env

1. 编辑 .env (MCP_PORT, PLUMRR_API_BASE_URL, LOG_LEVEL)
2. 开始：

docker compose up --build -d

1. 停止：

docker compose down

LibreChat配置

plumrr-mcp:
  title: "PluMRR API"
  description: "Read-only PluMRR MCP with stateless cookie auth forwarding"
  type: streamable-http
  url: "http://host.docker.internal:8001/mcp"
  headers:
    X-Plumrr-Email: "{{PLUMRR_EMAIL}}"
    X-Plumrr-Password: "{{PLUMRR_PASSWORD}}"
  customUserVars:
    PLUMRR_EMAIL:
      title: "PluMRR Email"
      description: "Your PluMRR email address"
    PLUMRR_PASSWORD:
      title: "PluMRR Password"
      description: "Your PluMRR password"

标头用于将凭证传递到MCP工具中。MCP不持久会话；调用者在每次工具调用时提供Cookie。

集成测试

test/integration-manual.mjs 现在使用环境驱动的目标：

• MCP_PORT （默认值 8001)
• MCP_BASE_URL （可选，覆盖 http://localhost:${MCP_PORT})
• PLUMRR_EMAIL （必填）
• PLUMRR_PASSWORD （必填）

例子：

PLUMRR_EMAIL="user@example.com" \
PLUMRR_PASSWORD="secret" \
MCP_PORT=8010 \
node test/integration-manual.mjs