MCPアトラシアン

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

概要

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

• Confluence : コンテンツの検索、スペースの取得、コンテンツの取得、ページの一覧表示

• Jira : 問題の検索、問題の詳細の取得、プロジェクトの一覧表示など

Related MCP server: MCP Atlassian

前提条件

• 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. プルリクエストを開く