看板管理工具

MCP-Businessmap是一个用于Businessmap(Kanbanize)的服务,提供搜索、查看和管理看板及卡片的功能。

  • by Anderson-SG
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Anderson-SG/mcp-bm

使用说明

MCP业务图

MCP Server for Businessmap (Kanbanize),可搜索、查看和管理图表和卡片。

工具

MCP-Businessmap 提供以下与 Businessmap 交互的工具:

  1. businessmap_search在 Businessmap 中搜索卡片。

    • 必需参数 :
      • query:要搜索的文本
    • 可选参数 :
      • board_ids:Quadros ID列表(由Virgula分隔)
      • max_results:最大结果数
  2. businessmap_get_card获取特定卡片的详细信息。

    • 必需参数 :
      • card_id卡 ID
  3. businessmap_create_card创建一张新卡片。

    • 必需参数 :
      • board_id框架 ID
      • workflow_id:ID执行工作流
      • lane_id:ID da车道
      • column_id列 ID:
      • title卡片标题
    • 可选参数 :
      • description卡片描述
      • priority卡优先级:
      • assignee_ids: 管理员 ID (以逗号分隔)
  4. businessmap_update_card更新现有卡片。

    • 必需参数 :
      • card_id卡 ID
    • 可选参数 :
      • title新标题
      • description新建描述
      • column_id新建列
      • lane_id:诺瓦巷
      • priority新优先级
      • assignee_ids新管理员(以逗号分隔)
  5. businessmap_delete_card删除一张卡片。

    • 必需参数 :
      • card_id卡 ID
  6. businessmap_add_comment向卡片添加注释。

    • 必需参数 :
      • card_id卡 ID
      • text: 注释文本

要求

  • Node.js 14+
  • 访问 Businessmap/Kanbanize 实例
  • API密钥做业务图

安装

npm install -g mcp-businessmap

使用

作为可执行文件

mcp-businessmap --transport=stdio --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY

作为 HTTP/SSE 服务器

mcp-businessmap --transport=sse --port=8000 --host=0.0.0.0 --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY

选项

  • --transport:传输协议(stdio 哦 sse)。默认 : stdio
  • --portHTTP 服务器端口(仅用于传输) sse)。默认 : 8000
  • --hostHTTP服务器的主机(仅用于传输) sse)。默认 : 0.0.0.0
  • --businessmap-url您的 Businessmap 实例的 URL。
  • --businessmap-apikey:API商务地图。
  • --businessmap-boards-filter:要过滤的Quadros ID列表(由Virgula分隔)。
  • --read-only只读模式(禁用写入操作)。默认 : false
  • --businessmap-ssl-verify验证SSL证书。默认 : true
  • --verbose详细日志。默认 : false

环境变量

而不是在命令行中传递参数,您可以使用环境变量:

  • BUSINESSMAP_URL您的 Businessmap 实例的 URL。
  • BUSINESSMAP_APIKEY:API商务地图。
  • BUSINESSMAP_BOARDS_FILTER:要过滤的Quadros ID列表(由Virgula分隔)。
  • READ_ONLY_MODE只读模式(true 哦 false).

Uso com n8n

若要将 MCP-Businessmap 与 n8n 配合使用:

  1. 在运行 n8n 的服务器上全局安装 mcp-businessmap 软件包:

    npm install -g mcp-businessmap
    
  2. 以 HTTP/SSE 服务器启动 MCP:

    mcp-businessmap --transport=sse --port=8001 --host=0.0.0.0 --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY --verbose
    
  3. 在 n8n 中,添加一个新的凭据:

    • 提示:MCP客户端(MCP服务器)
    • SSE网址: http://your-server-ip:8001/sse
    • 邮件发布端点: http://your-server-ip:8001/json-rpc
  4. 现在,您可以在工作流中使用 MCP 节点与 Businessmap 进行交互。

与 n8n 兼容性的改进

1.1.5版本为n8n兼容性带来了以下改进:

  • 全面支持CORS以避免连接问题
  • 默认监听所有网络接口
  • 更强大的 SSE 部署,每 30 秒心跳一次
  • 帮助诊断问题的详细日志
  • 用于监控的健康检查终端
  • 改进的错误处理
  • 修复了 Docker 和孤立环境的兼容性问题

开发

克隆仓库

git clone https://github.com/rlopes2-ops/-MCP-Businessmap.git
cd -MCP-Businessmap

安装依赖关系

npm install

以开发模式运行

npm run dev -- --transport=sse --port=8000 --businessmap-url=https://your-instance.businessmap.io --businessmap-apikey=YOUR_API_KEY

编译器

npm run build

许可证

麻省理工学院

免责声明

Businessmap和Kanbanize是其各自所有者的注册商标。该项目与Kanbanize或其子公司没有正式关系。