# Jira & Confluence MCP Servers
PythonベースのMCP（Model Context Protocol）サーバーで、JiraとConfluenceのAPIと対話できます。
## セットアップ
### 1. 依存関係のインストール
```bash
uv sync
```
### 2. 環境変数の設定
`.env.example`を`.env`にコピーして、認証情報を設定します：
```bash
cp .env.example .env
```
以下の情報を設定してください：
- `JIRA_URL` / `CONFLUENCE_URL`: AtlassianインスタンスのURL
- `JIRA_USERNAME` / `CONFLUENCE_USERNAME`: メールアドレス
- `JIRA_API_TOKEN` / `CONFLUENCE_API_TOKEN`: APIトークン（[こちら](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)から生成）
- `JIRA_CLOUD` / `CONFLUENCE_CLOUD`: クラウド版の場合は`true`、サーバー版の場合は`false`
## 使用方法
### Jira MCPサーバーの起動
```bash
uv run python src/jira_server.py
```
### Confluence MCPサーバーの起動
```bash
uv run python src/confluence_server.py
```
## 利用可能なツール
### Jira MCP
- `jira_search_issues`: JQLを使用してイシューを検索
- `jira_get_issue`: 特定のイシューの詳細を取得
- `jira_create_issue`: 新しいイシューを作成
- `jira_update_issue`: 既存のイシューを更新
- `jira_add_comment`: イシューにコメントを追加
- `jira_transition_issue`: イシューのステータスを変更
- `jira_get_projects`: プロジェクト一覧を取得
### Confluence MCP
- `confluence_search_content`: CQLを使用してコンテンツを検索
- `confluence_get_page`: ページの詳細を取得
- `confluence_create_page`: 新しいページを作成
- `confluence_update_page`: 既存のページを更新
- `confluence_delete_page`: ページを削除
- `confluence_get_spaces`: スペース一覧を取得
- `confluence_get_page_children`: 子ページを取得
- `confluence_add_attachment`: ページに添付ファイルを追加
## Claude Desktopでの設定
Claude Desktopの設定ファイル（`~/Library/Application Support/Claude/claude_desktop_config.json`）に以下を追加：
```json
{
"mcpServers": {
"jira": {
"command": "/path/to/jira-confluence-mcp/run_jira.sh",
"args": [],
"env": {
"JIRA_URL": "https://your-domain.atlassian.net",
"JIRA_USERNAME": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token",
"JIRA_CLOUD": "true"
}
},
"confluence": {
"command": "/path/to/jira-confluence-mcp/run_confluence.sh",
"args": [],
"env": {
"CONFLUENCE_URL": "https://your-domain.atlassian.net",
"CONFLUENCE_USERNAME": "your-email@example.com",
"CONFLUENCE_API_TOKEN": "your-api-token",
"CONFLUENCE_CLOUD": "true"
}
}
}
}
```
**注意**:
- `/path/to/jira-confluence-mcp/`の部分は実際のプロジェクトパスに置き換えてください
- APIトークンは[Atlassianアカウント設定](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)から生成できます
- `run_jira.sh`と`run_confluence.sh`は、プロジェクトルートにあるシェルスクリプトです
## 使用例
### Jira
```python
# イシューの検索
await jira_search_issues({"jql": "project = PROJ AND status = 'In Progress'", "max_results": 10})
# イシューの作成
await jira_create_issue({
"project_key": "PROJ",
"summary": "新しいタスク",
"description": "タスクの説明",
"issue_type": "Task",
"priority": "Medium"
})
# イシューのステータス変更
await jira_transition_issue({"issue_key": "PROJ-123", "status": "Done"})
```
### Confluence
```python
# ページの検索
await confluence_search_content({"cql": "space = DEV AND title ~ 'API'"})
# ページの作成
await confluence_create_page({
"space_key": "DEV",
"title": "新しいドキュメント",
"content": "<p>ページの内容</p>"
})
# ページの更新
await confluence_update_page({
"page_id": "123456",
"content": "<p>更新された内容</p>",
"version_comment": "APIドキュメントを更新"
})
```
## ライセンス
MIT
