MCP Atlassian

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for interacting with Atlassian products (Confluence and Jira) through a standardized interface

  • Allows searching content, getting spaces, retrieving content, and listing pages in Confluence

  • Enables searching issues, getting issue details, listing projects, and more in Jira

MCPアトラシアン

Atlassian 製品 (Confluence および Jira) と対話するためのツールを提供するモデル コンテキスト プロトコル (MCP) サーバー。

概要

このMCPサーバーは、AIエージェントが標準化されたインターフェースを介してアトラシアン製品と対話することを可能にします。以下のツールを提供します。

  • Confluence : コンテンツの検索、スペースの取得、コンテンツの取得、ページの一覧表示
  • Jira : 問題の検索、問題の詳細の取得、プロジェクトの一覧表示など

前提条件

  • Node.js (v16 以上)
  • npmまたはyarn
  • APIトークンを持つAtlassianアカウント
  • Docker(オプション、コンテナ化されたデプロイメント用)

インストール

標準インストール

  1. リポジトリをクローンします。
    git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
  2. 依存関係をインストールします:
    npm install # or using make make install
  3. Atlassian の資格情報を使用して、ルート ディレクトリに.envファイルを作成します。
    ATLASSIAN_HOST=https://your-domain.atlassian.net ATLASSIAN_EMAIL=your-email@example.com ATLASSIAN_API_TOKEN=your-api-token

Dockerのインストール

  1. リポジトリをクローンします。
    git clone https://github.com/yourusername/mcp-atlassian.git cd mcp-atlassian
  2. 上記の説明に従って.envファイルを作成します。
  3. Docker コンテナをビルドして実行します。
    # Build the Docker image make docker-build # Run the Docker container make docker-run # Or use Docker Compose make docker-compose

使用法

サーバーの起動

# Using npm npm start # Using make make start # Using Docker make docker-run

これにより、MCP サーバーが起動し、stdin で要求をリッスンし、stdout で応答します。

利用可能なツール

Confluenceツール

  • search-confluence : CQL を使用して Confluence 内のコンテンツを検索する
    • パラメータ: query (文字列)
  • get-confluence-space : 特定の Confluence スペースに関する情報を取得する
    • パラメータ: spaceKey (文字列)
  • get-confluence-content : IDで特定のコンテンツを取得する
    • パラメータ: contentId (文字列)
  • get-confluence-pages : スペース内のすべてのページを取得する
    • パラメータ: spaceKey (文字列)、 limit (数値、オプション)

Jiraツール

  • search-jira-issues : JQL を使用して問題を検索する
    • パラメータ: jql (文字列)、 maxResults (数値、オプション)
  • get-jira-issue : キーで特定の問題を取得する
    • パラメータ: issueKey (文字列)
  • get-jira-projects : すべてのプロジェクトを取得する
    • パラメータ: なし
  • get-jira-project : キーで特定のプロジェクトを取得する
    • パラメータ: projectKey (文字列)
  • get-jira-issue-types : すべての課題タイプを取得する
    • パラメータ: なし

発達

プロジェクト構造

src/ ├── config/ # Configuration files ├── examples/ # Example usage ├── services/ # Service classes for Atlassian APIs │ ├── confluence.ts │ └── jira.ts ├── tools/ # MCP tools │ ├── search-confluence.ts │ ├── get-confluence-space.ts │ ├── get-confluence-content.ts │ ├── get-confluence-pages.ts │ ├── search-jira-issues.ts │ ├── get-jira-issue.ts │ ├── get-jira-projects.ts │ ├── get-jira-project.ts │ ├── get-jira-issue-types.ts │ ├── utils.ts │ └── index.ts └── index.ts # Main entry point

建物

# Using npm npm run build # Using make make build

テスト

# Using npm npm test # Using make make test

Makefileコマンド

このプロジェクトには、一般的な操作を簡素化する Makefile が含まれています。

# Display available commands make help

ライセンス

マサチューセッツ工科大学

貢献

  1. リポジトリをフォークする
  2. 機能ブランチを作成します( git checkout -b feature/amazing-feature
  3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
  4. ブランチにプッシュする ( git push origin feature/amazing-feature )
  5. プルリクエストを開く
-
security - not tested
F
license - not found
-
quality - not tested

AI エージェントが Atlassian 製品 (Confluence および Jira) と対話して、標準化されたインターフェースを通じてコンテンツ管理、問題追跡、プロジェクト管理を行えるようにする MCP サーバー。

  1. Overview
    1. Prerequisites
      1. Installation
        1. Standard Installation
        2. Docker Installation
      2. Usage
        1. Starting the Server
        2. Available Tools
      3. Development
        1. Project Structure
        2. Building
        3. Testing
        4. Makefile Commands
      4. License
        1. Contributing
          ID: w8drdld8a6