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"]