alces-mcp

本地服务

gitlab.com/moosejudge生产力

代码仓库

关于 alces-mcp

面向 Jira Data Center 的 Alces：一个 MCP 服务，用于连接 Jira DC/JSM 与 AI Agent。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "com-moosejudge-alces": {
      "command": "npx",
      "args": [
        "-y",
        "alces-mcp"
      ],
      "env": {
        "JIRA_URL": "<JIRA_URL>",
        "JIRA_USER_TOKEN": "<JIRA_USER_TOKEN>",
        "JIRA_ADMIN_TOKEN": "<JIRA_ADMIN_TOKEN>",
        "JIRA_TIMEOUT_MS": "<JIRA_TIMEOUT_MS>",
        "ALCES_TOOL_GROUPS": "<ALCES_TOOL_GROUPS>",
        "ALCES_TOKEN_ESCALATION_DOMAINS": "<ALCES_TOKEN_ESCALATION_DOMAINS>",
        "JIRA_SESSION_USERNAME": "<JIRA_SESSION_USERNAME>",
        "JIRA_SESSION_PASSWORD": "<JIRA_SESSION_PASSWORD>"
      }
    }
  }
}

启动命令npx -y alces-mcp

需要配置的环境变量

JIRA_URLBase URL of the Jira Data Center instance

JIRA_USER_TOKEN密钥Personal Access Token for standard operations

JIRA_ADMIN_TOKEN密钥Personal Access Token for elevated/admin operations (optional)

JIRA_TIMEOUT_MSTimeout in milliseconds for every Jira API call. Defaults to 30000 (30s) when unset or blank; raise it if your instance is slow.

ALCES_TOOL_GROUPSComma-separated tool domains to pre-activate at startup instead of the core-issues default (core-issues, jsm-service-desk, assets, issue-detail, agile, projects, filters-personal-settings, users-groups-permissions, admin). Unknown names are warned about on stderr and ignored.

ALCES_TOKEN_ESCALATION_DOMAINS密钥Comma-separated tool domains allowed to substitute JIRA_ADMIN_TOKEN via token escalation. Empty by default — no tool may escalate until its domain is listed here.

JIRA_SESSION_USERNAMEOptional Jira DC account username (not a PAT), paired with JIRA_SESSION_PASSWORD, enabling session-cookie auth for the legacy avatar upload/crop/finalize tools. Must be the same account as JIRA_USER_TOKEN and must not be an administrator: those tools authenticate as this account rather than the token.

JIRA_SESSION_PASSWORD密钥Password for JIRA_SESSION_USERNAME. Only used to establish a session cookie for the legacy avatar upload/crop/finalize tools.

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

安装包

npmalces-mcp1.1.0stdio

工具

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

参数	类型	必填	说明
tag	string	否	筛选目录标签包含此子字符串的操作（例如 "Assets - Object"）。
search	string	否	筛选路径、摘要或 operationId 包含此子字符串的操作。
category	enum	否	要获取参考资料的 API 类别。省略则返回类别概览。core \| jsm \| admin