MCP Multi Jira

mcp multi-jira


多账户Jira MCP服务器。配置多个Atlassian Jira帐户，并按帐户别名路由工具调用。

项目目标

大多数Jira MCP设置都是单个帐户，如果你经常在以下两个帐户之间切换，这会很痛苦：

• 工作+个人Jira
• 多个客户/租户
• 使用不同权限分隔Jira站点

此项目的存在是为了提供 单MCP服务器 可以坚持 多个Jira帐户 并通过显式方式路由每个工具调用 account 参数（这样您的代理配置在提示中告诉它使用不同的帐户时保持稳定）。

此项目具有以下功能：

• 可选的加密或操作系统密钥链令牌存储
• 适用于常见的MCP客户端（Cursor、Claude Code、Codex CLI）
• 为受支持的代理自动安装MCP配置

快速启动

首先，设置您的帐户：

npx -y mcp-multi-jira login Work
npx -y mcp-multi-jira login Personal

然后，在您最喜欢的编码代理中安装MCP：

npx -y mcp-multi-jira install

就是这样！重新启动编码代理/IDE以获取新的MCP服务器。

CLI参考

登录帐户：

mcp-multi-jira login WorkJira

列出帐户：

mcp-multi-jira list

启动服务器： （注意：如果您使用install命令，服务器将由代理自动启动）

mcp-multi-jira serve

为支持的代理安装MCP配置：

mcp-multi-jira install

高级用法

更改令牌存储

默认情况下，令牌存储在明文文件中。要使用加密或操作系统密钥链，请使用以下命令设置默认后端：

# Options: plain (default), encrypted, keychain
mcp-multi-jira token-store encrypted

如果您使用加密存储，请确保您的环境设置了主密码，否则MCP将无法启动：

export MCP_JIRA_TOKEN_PASSWORD="your-master-password"

明文令牌存储在 ~/.mcp-jira/tokens.json （不要在共享计算机上使用）。

当切换令牌存储和已存在的帐户时，CLI将提示将令牌迁移到新后端。

覆盖OAuth客户端

export MCP_JIRA_CLIENT_ID="your-client-id"
export MCP_JIRA_CLIENT_SECRET="your-client-secret"

手动代理配置

您可以自动安装代理配置：

mcp-multi-jira install

下面是高级设置的手动片段。

光标

~/.cursor/mcp.json （或每个项目 .cursor/mcp.json):

{
  "mcpServers": {
    "mcp-jira": {
      "command": "npx",
      "args": ["-y", "mcp-multi-jira", "serve"]
    }
  }
}

克劳德代码

~/.claude/mcp_servers.json:

{
  "mcpServers": {
    "mcp-jira": {
      "command": "npx",
      "args": ["-y", "mcp-multi-jira", "serve"]
    }
  }
}

OpenAI Codex命令行界面

~/.codex/config.toml:

[mcp_servers.mcp_jira]
command = "npx"
args = ["-y", "mcp-multi-jira", "serve"]