Skip to main content
Glama
propyte-mejoras-mcp

propyte-mejoras-mcp

by Propyte-Luis

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: @modusop/mcp-server

安装

需要 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_TOKEN

是

—

MCP_MEJORAS_URL

否

https://hub.propyte.com/api/mcp/mejoras

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。它们是三个不同的密钥,对应三扇不同的门。

可以用这些工具做什么

工具

写入

用途

mejoras_list_tasks

否

查看按项目、状态或优先级筛选的看板

mejoras_get_task

否

一个完整任务,包括其验证和证据

mejoras_create_task

是

登记发现的改进

mejoras_update_task

是

更改状态、优先级或证据

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

  • 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 会作为带有原因的错误到达客户端,而不是沉默。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A minimal Python-based proxy that bridges local MCP STDIO clients with remote MCP SSE servers. It enables bidirectional JSON-RPC message passing between standard command-line tools and web-based remote endpoints.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Acts as a stdio-to-HTTP proxy for Modus Brain, enabling MCP-compatible AI clients to access an organization's knowledge base in ModusOp.
      53 npm
      -
    • A
      license
      C
      quality
      C
      maintenance
      Minimal MCP server exposing the Connectif HTTP API to MCP clients over stdio, enabling operations like contacts, purchases, products, exports, imports, workflows, and more.
      12
      8 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A thin stdio-to-HTTP bridge that forwards MCP messages to the hosted Proxycept server, enabling stdio-only MCP clients to access Proxycept's tool catalog.
      12 npm
      MIT