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

使用法

サーバーの起動

これにより、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 : すべての課題タイプを取得する

  • パラメータ: なし

発達

プロジェクト構造

建物

テスト

Makefileコマンド

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

ライセンス

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

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く