MCP Server for JIRA

このModel Context Protocol (MCP) サーバーは、JIRAとの連携機能を提供します。ChatGPTやその他のAIアシスタントがJIRAのイシューを直接操作できるようになります。

機能

このMCPサーバーは以下のツールを提供します：

get_issue: JIRAイシューの詳細情報を取得

インストール

# リポジトリをクローン
git clone https://github.com/kuvanov-2/mcp-server-jira.git
cd mcp-server-jira

# 依存関係をインストール
npm install

# ビルド
npm run build

設定

MCPサーバーを使用するには、以下の設定を行う必要があります：

1. 事前準備

1-1. 1Password CLIの設定

1Passwordのデスクトップアプリをインストールしておきます。

1Password CLIをインストールします。

brew install 1password-cli

1Password（デスクトップアプリ）の設定で、CLI連携を有効にします。

1-2. JIRAのAPIトークンの取得

こちらからJIRA API TOKENを取得します。

JIRAのAPIトークンを1Passwordに保存

2. Visual Studio Codeの設定

設定ファイルを開きます：

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

以下の設定を追加します：

{
  "mcpServers": {
	"github.com/kuvanov-2/mcp-server-jira": {
	  "command": "/path/to/mcp-server-jira/start-server.sh",
	  "env": {
		"JIRA_HOST": "https://your-domain.atlassian.net",
		"JIRA_EMAIL": "[email protected]",
		"JIRA_API_TOKEN": "op://YOUR_VAULT_NAME/YOUR_ITEM_NAME/info/access token" 
	  },
	  "disabled": false,
	  "autoApprove": []
	}
  }
}

環境変数の説明：

JIRA_HOST: JIRAのホストURL
JIRA_EMAIL: JIRAのアカウントメールアドレス
JIRA_API_TOKEN: 1Password内に保存されたJIRA APIトークンへの参照

JIRAのAPI TOKENは、1Passwordに保存する想定です。 JIRA API Tokenには、1Passwordの該当フィールドへのパスを指定します。パスはフィールド右クリックからコピーできます。

start-server.shスクリプトが自動的に1Password CLIを使用して環境変数を解決し、サーバーを起動します。

使用方法

get_issue

JIRAのイシューの詳細情報を取得します。

<use_mcp_tool>
<server_name>github.com/kuvanov-2/mcp-server-jira</server_name>
<tool_name>get_issue</tool_name>
<arguments>
{
  "issueKey": "PROJ-123"
}
</arguments>
</use_mcp_tool>

ライセンス

MIT