MCP Multi Jira

🚀 mcp-multi-jira

支持多账户的Jira MCP服务器，可配置多个Atlassian Jira账户，并通过账户别名路由工具调用。

🚀 快速开始

首先，设置你的账户：

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

然后，在你喜欢的编码工具中安装MCP：

npx -y mcp-multi-jira install

完成！重启你的编码工具或IDE以启用新的MCP服务器。

✨ 主要特性

• 大多数Jira MCP设置为单账户，若你需要频繁在以下场景间切换会十分痛苦：
  • 工作和个人Jira账户
  • 多个客户/租户
  • 不同权限的独立Jira站点

本项目旨在提供一个单一的MCP服务器，它可以管理多个Jira账户，并通过显式的 account 参数路由每个工具调用（因此你的代理配置可以保持稳定，同时你可以在提示中指定使用不同的账户）。

本项目具有以下特点：

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

📦 安装指南

账户设置

npx -y mcp-multi-jira login WorkJira

安装MCP

npx -y mcp-multi-jira install

💻 使用示例

基础用法

登录账户

mcp-multi-jira login WorkJira

列出账户

mcp-multi-jira list

启动服务器

mcp-multi-jira serve

为支持的代理安装MCP配置

mcp-multi-jira install

高级用法

更改令牌存储

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

# 选项: plain (默认), 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

~/.cursor/mcp.json（或每个项目的 .cursor/mcp.json）：

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

Claude Code

~/.claude/mcp_servers.json：

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

OpenAI Codex CLI

~/.codex/config.toml：

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