trackmcp
Back to directory
katsuhirohonda

jira-confluence-mcp

View on GitHub

Jira & Confluence MCP Servers

0 stars PythonOthers Updated Jan 3, 2026

Documentation

Jira & Confluence MCP Servers

PythonベースのMCP(Model Context Protocol)サーバーで、JiraとConfluenceのAPIと対話できます。

セットアップ

1. 依存関係のインストール

bash
uv sync

2. 環境変数の設定

`.env.example`を`.env`にコピーして、認証情報を設定します:

bash
cp .env.example .env

以下の情報を設定してください:

  • `JIRA_URL` / `CONFLUENCE_URL`: AtlassianインスタンスのURL
  • `JIRA_USERNAME` / `CONFLUENCE_USERNAME`: メールアドレス
  • `JIRA_API_TOKEN` / `CONFLUENCE_API_TOKEN`: APIトークン(こちらから生成)
  • `JIRA_CLOUD` / `CONFLUENCE_CLOUD`: クラウド版の場合は`true`、サーバー版の場合は`false`

使用方法

Jira MCPサーバーの起動

bash
uv run python src/jira_server.py

Confluence MCPサーバーの起動

bash
uv run python src/confluence_server.py

利用可能なツール

Jira MCP

  • `jira_search_issues`: JQLを使用してイシューを検索
  • `jira_get_issue`: 特定のイシューの詳細を取得
  • `jira_create_issue`: 新しいイシューを作成
  • `jira_update_issue`: 既存のイシューを更新
  • `jira_add_comment`: イシューにコメントを追加
  • `jira_transition_issue`: イシューのステータスを変更
  • `jira_get_projects`: プロジェクト一覧を取得

Confluence MCP

  • `confluence_search_content`: CQLを使用してコンテンツを検索
  • `confluence_get_page`: ページの詳細を取得
  • `confluence_create_page`: 新しいページを作成
  • `confluence_update_page`: 既存のページを更新
  • `confluence_delete_page`: ページを削除
  • `confluence_get_spaces`: スペース一覧を取得
  • `confluence_get_page_children`: 子ページを取得
  • `confluence_add_attachment`: ページに添付ファイルを追加

Claude Desktopでの設定

Claude Desktopの設定ファイル(`~/Library/Application Support/Claude/claude_desktop_config.json`)に以下を追加:

json
{
  "mcpServers": {
    "jira": {
      "command": "/path/to/jira-confluence-mcp/run_jira.sh",
      "args": [],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_CLOUD": "true"
      }
    },
    "confluence": {
      "command": "/path/to/jira-confluence-mcp/run_confluence.sh",
      "args": [],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USERNAME": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_CLOUD": "true"
      }
    }
  }
}

注意:

  • `/path/to/jira-confluence-mcp/`の部分は実際のプロジェクトパスに置き換えてください
  • APIトークンはAtlassianアカウント設定から生成できます
  • `run_jira.sh`と`run_confluence.sh`は、プロジェクトルートにあるシェルスクリプトです

使用例

Jira

python
# イシューの検索
await jira_search_issues({"jql": "project = PROJ AND status = 'In Progress'", "max_results": 10})

# イシューの作成
await jira_create_issue({
    "project_key": "PROJ",
    "summary": "新しいタスク",
    "description": "タスクの説明",
    "issue_type": "Task",
    "priority": "Medium"
})

# イシューのステータス変更
await jira_transition_issue({"issue_key": "PROJ-123", "status": "Done"})

Confluence

python
# ページの検索
await confluence_search_content({"cql": "space = DEV AND title ~ 'API'"})

# ページの作成
await confluence_create_page({
    "space_key": "DEV",
    "title": "新しいドキュメント",
    "content": "ページの内容"
})

# ページの更新
await confluence_update_page({
    "page_id": "123456",
    "content": "更新された内容",
    "version_comment": "APIドキュメントを更新"
})

ライセンス

MIT

Frequently asked questions

What is jira-confluence-mcp?

jira-confluence-mcp is Jira & Confluence MCP Servers

How do I install jira-confluence-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is jira-confluence-mcp open source?

Yes — it is hosted on GitHub at https://github.com/katsuhirohonda/jira-confluence-mcp.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP