mcpField
E
elma365-mcp

elma365-mcp

本地服务
github.com/theYahia商业与营销18 周前更新

关于 elma365-mcp

elma365-mcp 将 ELMA365 的应用与 BPM API 接入 MCP,面向需要在对话中查询和操作业务数据的团队。它涵盖应用条目、流程、任务、用户和评论。

主要功能

  1. 01查询和创建应用条目
  2. 02查询 BPM 任务和业务流程
  3. 03启动业务流程
  4. 04查询用户与评论
  5. 05为应用条目添加评论

适用场景

  1. 01在聊天中查看 BPM 任务
  2. 02从应用中查找或创建条目
  3. 03启动业务审批流程
  4. 04查看或添加条目评论

MCP 相关

该 MCP 服务向 MCP 客户端提供 ELMA365 API 工具,涵盖应用条目、任务、流程、用户和评论。支持 stdio 与 Streamable HTTP。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"theyahia-elma365": {
"command": "npx",
"args": [
"-y",
"@theyahia/elma365-mcp"
],
"env": {
"ELMA365_DOMAIN": "<ELMA365_DOMAIN>"
}
}
}
}
启动命令npx -y @theyahia/elma365-mcp
需要配置的环境变量
ELMA365_DOMAIN密钥API key for the service

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@theyahia/elma365-mcp1.0.0

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
codestring是应用代码
fromnumber否分页偏移量(默认为 0)
sizenumber否条目数量(默认 50)
namespacestring是应用命名空间(namespace)

详细介绍

ELMA365 MCP 服务——通过 AI 管理 BPM 任务和 low-code 平台应用

如果你想了解如何将 ELMA365 连接到神经网络、启动业务流程并在不进入 Web 界面的情况下完成 BPM 任务,这就是你要找的工具。共 9 个工具:应用项、任务、流程、用户、评论。询问“我今天的任务”即可获取列表,并直接在聊天中完成任务。

npm License: MIT CI

这是 @theYahia 的 WWmcp 系列的一部分(46 个服务)。

安装

Claude Desktop
{
  "mcpServers": {
    "elma365": {
      "command": "npx",
      "args": ["-y", "@theyahia/elma365-mcp"],
      "env": {
        "ELMA365_DOMAIN": "mycompany",
        "ELMA365_TOKEN": "your-token"
      }
    }
  }
}
Claude Code
claude mcp add elma365 \
  -e ELMA365_DOMAIN=mycompany \
  -e ELMA365_TOKEN=your-token \
  -- npx -y @theyahia/elma365-mcp
VS Code / Cursor
{
  "servers": {
    "elma365": {
      "command": "npx",
      "args": ["-y", "@theyahia/elma365-mcp"],
      "env": {
        "ELMA365_DOMAIN": "mycompany",
        "ELMA365_TOKEN": "your-token"
      }
    }
  }
}
Streamable HTTP(适用于 Web 客户端)
ELMA365_DOMAIN=mycompany ELMA365_TOKEN=your-token npx @theyahia/elma365-mcp --http --port 3000

Endpoint:http://localhost:3000/mcp Health check:http://localhost:3000/health

Smithery

使用仓库根目录中的 smithery.yaml 部署到 Smithery。

需要 ELMA365_DOMAIN(ELMA365 域名或子域名,例如 mycompany)和 ELMA365_TOKEN(Bearer API 令牌)。

工具(9 个)

工具说明
get_app_items按 namespace 和 code 获取应用项列表
create_item在应用中创建新项
get_tasks获取 BPM 任务列表
get_processes获取业务流程列表
start_process按代码启动业务流程
get_users获取用户列表
get_user_by_id按 ID 获取用户
get_comments获取应用项的评论
add_comment为应用项添加评论

Skills(Claude Code)

Skill说明
/skill-my-tasks我的任务——显示当前 BPM 任务
/skill-start-process按代码启动业务流程

示例

Покажи элементы приложения deals/crm_deals
Создай новый элемент в приложении hr/candidates
Покажи мои BPM-задачи
Покажи список бизнес-процессов
Запусти процесс approval_flow с параметрами {"amount": 50000}
Покажи пользователей
Покажи комментарии к элементу item-123 в deals/crm_deals
Добавь комментарий "Согласовано" к элементу item-123 в deals/crm_deals

传输方式

模式命令说明
stdio(默认)npx @theyahia/elma365-mcp适用于 Claude Desktop、Claude Code、Cursor
Streamable HTTPnpx @theyahia/elma365-mcp --http适用于 Web 客户端,默认端口为 3000
Streamable HTTP(端口)npx @theyahia/elma365-mcp --http --port 8080自定义端口

身份验证

  • ELMA365_DOMAIN — ELMA365 域名(例如,mycompany 对应 mycompany.elma365.ru,也可以使用完整域名 mycompany.elma365.ru)
  • ELMA365_TOKEN — ELMA365 API 的 Bearer 令牌

基础 URL:https://{domain}.elma365.ru/pub/v1/

开发

npm install
npm run build
npm test
npm run dev    # запуск через tsx

许可证

MIT


属于 WWmcp · Telegram: @vhodvai

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。