propyte-mejoras-mcp

用于 Propyte 的 Mejoras IA 看板的 stdio 桥接。让 Claude Desktop、Claude Code 以及任何支持 stdio 的 MCP 客户端都能读写 hub.propyte.com 的看板。

它是什么，不是什么

这个包不实现任何工具。它只转换传输层，仅此而已：客户端通过 stdin 按行说 JSON-RPC，Hub 的门通过 POST 说 JSON-RPC。

Claude Desktop / Claude Code
        │  stdio (JSON-RPC por líneas)
        ▼
  propyte-mejoras-mcp          ← este paquete: 250 líneas, cero dependencias
        │  HTTPS POST + Authorization: Bearer
        ▼
  hub.propyte.com/api/mcp/mejoras
        │
        ▼
  el tablero (ai_tasks)

这些工具、它们的验证以及写入后的重新读取都在 Hub 中。两个实际后果：

• 当 Hub 发布新工具时，它们会自动出现在你的客户端中。无需更新这个包。

• 不存在第二份可能与 Hub 规则不同步的看板规则副本。

如果你使用 Claude Cowork 或 claude.ai，则不需要这个：在那里可以直接将 URL 添加为自定义连接器。这个桥接是为那些只讲 stdio 的客户端而存在的。

Related MCP server: mcp-streaming-http-proxy

安装

需要 Node 20 或更高版本。无需编译任何东西，也无需安装依赖。

1. 获取 token

从 hub.propyte.com/mejoras/conectar 复制（需要是 ADMIN 或 DIRECTOR）。该屏幕还会显示上次轮换的日期。

不要通过聊天索要 token，也不要从文档中复制：屏幕是唯一知道该密钥是否仍然有效的来源。

2. 配置你的客户端

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "propyte-mejoras": {
      "command": "npx",
      "args": ["-y", "github:Propyte-Luis/propyte-mejoras-mcp"],
      "env": {
        "MCP_MEJORAS_TOKEN": "el-token-de-/mejoras/conectar"
      }
    }
  }
}

Claude Code — 一行：

claude mcp add propyte-mejoras \
  --env MCP_MEJORAS_TOKEN=el-token-de-/mejoras/conectar \
  -- npx -y github:Propyte-Luis/propyte-mejoras-mcp

3. 检查它是否已启动

重启客户端并请求工具列表。你应该会看到看板的那些工具（mejoras_list_tasks、mejoras_get_task、mejoras_create_task、mejoras_update_task）。

如果你更想手动测试，不通过客户端：

export MCP_MEJORAS_TOKEN=...
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y github:Propyte-Luis/propyte-mejoras-mcp

配置

MCP_MEJORAS_URL 仅在指向本地 Hub 时才需要更改（http://localhost:3001/api/mcp/mejoras）。

没有 MCP_MEJORAS_TOKEN 桥接不会启动，并以退出码 1 结束，同时说明缺少哪个变量。这是故意的：一个没有 token 就启动的桥接会让客户端面对一个对所有请求都回答“未授权”的服务器，而这会被解读为“Hub 已宕机”——从而让人去检查错误的地方。

⚠️ MCP_MEJORAS_TOKEN 不是 MCP_BLOG_TOKEN，也不是 MCP_API_TOKEN。它们是三个不同的密钥，对应三扇不同的门。

可以用这些工具做什么

服务器强制实施的两条规则，不是这个桥接：

• resumen_humano 必须说明发生了什么变化，以便看不到代码的人也能理解。 泛泛的摘要会被拒绝，并附上有用的示例。

• estado = 'desplegada' 要求提供证据。 没有证据的绿色徽章正是该面板要阻止的。

安全

• 密钥通过请求头传输，而不是在路径中。该门接受两种方式——路径之所以存在是因为 Cowork 无法发送请求头——但路径会留在服务器的访问日志中，而本地进程没有必要承担这个代价。有一个测试会验证这一点。

• stdout 中只输出 JSON-RPC 消息。 其他所有内容都输出到 stderr；stdout 中的任何其他内容都会被客户端当作协议来读取，并关闭连接。

• 这是一个共享 token，可以从 /mejoras/conectar 轮换。它不是数据库凭据，这个门的任何工具都不会写入 CRM。

开发

npm test    # 13 tests, cero dependencias

测试针对 localhost 上的一个假 MCP 门运行，其中两个测试将二进制文件作为进程来执行——而不是模块——因为损坏的 shebang 或被遗忘的 console.log 是任何单元测试都抓不到的，而客户端上的症状只是“服务器无法启动”，没有更多信息。

它们验证的内容：tools/list 完整通过，桥接不会凭空发明或删减工具；token 不会出现在 URL 中；通知不会产生响应；被分成两段 stdin 的消息不会损坏；SSE 响应在解包时忽略 keepalive ping；401 或 500 会作为带有原因的错误到达客户端，而不是沉默。