MCPアトラシアン
Atlassian 製品 (Confluence および Jira) と対話するためのツールを提供するモデル コンテキスト プロトコル (MCP) サーバー。
概要
このMCPサーバーは、AIエージェントが標準化されたインターフェースを介してアトラシアン製品と対話することを可能にします。以下のツールを提供します。
- Confluence : コンテンツの検索、スペースの取得、コンテンツの取得、ページの一覧表示
- Jira : 問題の検索、問題の詳細の取得、プロジェクトの一覧表示など
前提条件
- Node.js (v16 以上)
- npmまたはyarn
- APIトークンを持つAtlassianアカウント
- Docker（オプション、コンテナ化されたデプロイメント用）
インストール
標準インストール
- リポジトリをクローンします。
git clone https://github.com/yourusername/mcp-atlassian.git
cd mcp-atlassian
- 依存関係をインストールします:
npm install
# or using make
make install
- Atlassian の資格情報を使用して、ルート ディレクトリに
.envファイルを作成します。ATLASSIAN_HOST=https://your-domain.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_TOKEN=your-api-token
Dockerのインストール
- リポジトリをクローンします。
git clone https://github.com/yourusername/mcp-atlassian.git
cd mcp-atlassian
- 上記の説明に従って
.envファイルを作成します。 - 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 内のコンテンツを検索する
- get-confluence-space : 特定の Confluence スペースに関する情報を取得する
- get-confluence-content : IDで特定のコンテンツを取得する
- get-confluence-pages : スペース内のすべてのページを取得する
- パラメータ:
spaceKey (文字列)、 limit (数値、オプション)
Jiraツール
- search-jira-issues : JQL を使用して問題を検索する
- パラメータ:
jql (文字列)、 maxResults (数値、オプション)
- get-jira-issue : キーで特定の問題を取得する
- get-jira-projects : すべてのプロジェクトを取得する
- get-jira-project : キーで特定のプロジェクトを取得する
- 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
ライセンス
マサチューセッツ工科大学
貢献
- リポジトリをフォークする
- 機能ブランチを作成します（
git checkout -b feature/amazing-feature ） - 変更をコミットします (
git commit -m 'Add some amazing feature' ) - ブランチにプッシュする (
git push origin feature/amazing-feature ) - プルリクエストを開く