Jeero MCP

Jeero MCP

Jeero MCP 是一个用于 Jeero 订阅和活动数据的本地 Model Context Protocol 服务。它会与 Mother 同步，并在 SQLite 中缓存本地活动数据；无需 WordPress 或托管的 MCP 服务。

安装

使用 Node.js 20 或更高版本，并将 MCP 客户端配置为运行已发布的软件包：

{
  "mcpServers": {
    "jeero": {
      "command": "npx",
      "args": ["-y", "jeero-mcp"]
    }
  }
}

服务通过 stdio 通信。请勿将应用日志写入 stdout。

首次使用

使用 create_subscription 创建订阅，然后在不提供设置的情况下调用 config_subscription。当客户端声明支持 MCP URL 引导时，Jeero 会打开一个私密配置流程。否则，该工具会返回一个链接和访问码。请自行打开链接，输入访问码，选择票务解决方案并保存，以加载其连接器专属字段。请仅在该浏览器页面中输入密钥。请保持页面私密：不要让 Agent 或其浏览器工具检查或填写该页面。

配置页面会在与 MCP 服务同一台计算机的 127.0.0.1 上运行。链接会在 15 分钟后或服务停止时失效。如果应用的 URL 提示无法使用，请调用 config_subscription 并设置 manual: true，以获取新链接。此本地页面需要在 MCP 服务所在计算机上使用浏览器；它不是远程托管的配置门户。

只有 settings.theater 仍可通过 create_subscription 或 config_subscription 提供。其他设置（包括所有凭据）都必须在浏览器中输入。已保存的现有设置仍可继续使用。此设计有意取代了之前任意输入设置和原始订阅信封的方式：现在，get_subscription 和 create_subscription 会返回摘要，其中包含已配置的字段名称、必填字段的完整性以及连接错误计数。完整性并不能证明密钥有效；请同时检查同步情况。这些工具绝不会返回 Mother 的原始元数据、字段值或已保存的凭据。

可以将一个订阅设为默认订阅；省略 subscription 时，工具会使用该订阅。支持多个活跃订阅。

get_events 每分钟最多同步一次所选订阅。服务运行期间，也会每分钟检查活跃订阅。需要立即刷新时，请使用 sync_subscription 或 sync_subscriptions 并设置 force: true。

工具

• 订阅管理：list_subscriptions、create_subscription、get_subscription、config_subscription、set_default_subscription、activate_subscription、deactivate_subscription
• 同步：sync_subscription、sync_subscriptions
• 活动数据：get_events、get_event、list_event_categories、get_ticket_snapshots、get_logs

本地数据和配置

默认情况下，Jeero MCP 会将其 SQLite 缓存和持久化站点身份存储在 ~/.jeero-mcp/ 中。请妥善保护此目录：Mother 请求会使用该身份。

凭据仍保存在本地 SQLite 设置中，并通过其现有 API 发送给 Mother。此更改可防止凭据出现在 MCP 工具的回答和错误中；但不会加密数据库，也不会从旧聊天记录或现有调试文件中删除密钥。工具输出和新导入的日志会对已知凭据进行脱敏；请求跟踪不会记录查询字符串和响应正文。配置界面不会加载任何第三方脚本或资源。

新安装会使用随机 UUID 作为站点标识符，并将其保存在 site-identity.json 中，在每次重启时重复使用。现有安装会保留已保存的标识符和密钥，以便继续访问其 Mother 订阅和收件箱。请勿在独立安装之间复制此身份文件。

变量	用途
JEERO_DATA_DIR	覆盖本地数据目录。
JEERO_SITE_URL	新安装的可选站点标识符覆盖值；默认为随机 UUID。已保存的身份优先。
JEERO_MOTHER_BASE_URL	覆盖 Mother 的基础 URL，例如用于预发布环境。
JEERO_NO_OF_ITEMS_PER_PICKUP	限制每次同步请求的收件箱条目数。
JEERO_LOG_MOTHER	使用 true、1、yes 或 on 启用 Mother 请求跟踪。
JEERO_LOG_MOTHER_FILE	覆盖跟踪日志路径。

Mother 仍是上游事实来源。Jeero MCP 存储已处理的事件记录和同步状态，而不存储原始收件箱负载。

开发

npm install
npm test
npm pack --dry-run

基于标签的发布工作流要求先明确批准仓库发布，才能发布版本标签。

许可证

MIT