Jira Prompts MCP Server

Jira Prompts MCP Server

このリポジトリでは、Jira のコンテンツからプロンプトまたはコンテキストを生成する複数のコマンドを提供する、Model Context Protocol（MCP）サーバーを提供します。

このリポジトリは、MarkItDown MCP server とサンプルの Git MCP server から大きな着想を得ています。また、mcp-atlassian リポジトリの設計およびコードの要素も取り入れています。このリポジトリと mcp-atlassian の主な違いは、Jira API とのやり取りに atlassian-api/atlassian-python-api ではなく pycontribs/jira を使用することと、ツールではなくプロンプトの提供に重点を置いていることです。後者の特徴により、Zed の AI アシスタントなど、MCP プロンプトのみをサポートするツールとの連携に特に役立ちます。

私が開発した別の MCP サーバープロジェクトはこちらです：ceshine/git-prompts-mcp-server

変更履歴

0.1.0

• 低レベルの mcp package から FastMCP パッケージに移行しました。
• サーバーをテストするための CLI を追加しました。

0.0.1

jira-issue-brief と jira-issue-full の 2 つのプロンプトを実装した初回リリースです。

インストール

手動インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：uv sync --frozen

使用方法

Zed Editor の MCP サーバーとして使用する

settings.json に以下を追加します：

"context_servers": {
  "git_prompt_mcp": {
    "command": {
      "path": "uv",
      "args": [
        "--directory",
        "/path/to/local/jira_prompts_mcp_server",
        "run",
        "jira-prompts-mcp-server",
        "https://my-company.atlassian.net", // Jira base URL
        "[email protected]",  // Jira username
        "your_api_key"  // Jira API token (https://id.atlassian.com/manage-profile/security/api-tokens)
      ]
    },
    "settings": {}
  }
}

コマンド

サーバーは以下のコマンドに応答します：

1. jira-issue-brief <issue-key>：Jira 課題の主要フィールドを取得します。引数として課題キー（例：PROJ-123）が必要です。
2. jira-issue-full <issue-key>：Jira 課題の主要フィールド、コメント、リンクされた課題、およびサブタスクを取得します。引数として課題キーが必要です。

例：

1. /jira-issue-brief PROJ-123
2. /jira-issue-brief PROJ-155

CLI を使用したサーバーのテスト

前提条件：必要な環境変数（JIRA_URL、JIRA_USERNAME、JIRA_API_TOKEN）を設定しておく必要があります。

CLI を使用して MCP サーバーをすばやくテストできます。コマンドの例を以下に示します：

• uv run python -m jira_prompts_mcp_server.cli jira-brief BOOM-1234
• uv run python -m jira_prompts_mcp_server.cli jira-full BOOM-1234

ライセンス

MIT License。詳細は LICENSE を参照してください。