propyte-mejoras-mcp
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-mcp3. 检查它是否已启动
重启客户端并请求工具列表。你应该会看到看板的那些工具(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 会作为带有原因的错误到达客户端,而不是沉默。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Remote MCP server for AIStoryHub: stories, chapters, story bible, Voiceprints, AI generation.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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-
- FlicenseNot gradedqualityDmaintenanceActs 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-
- AlicenseCqualityCmaintenanceMinimal MCP server exposing the Connectif HTTP API to MCP clients over stdio, enabling operations like contacts, purchases, products, exports, imports, workflows, and more.128 npmMIT
- AlicenseNot gradedqualityDmaintenanceA 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 npmMIT