backlog-mcp

AIエージェントにストーリーベースのプロジェクトバックログへの構造化された読み取り/書き込みアクセスを提供するMCPサーバーです。エージェントは、ストーリーの一覧表示、コンテンツの読み取り、ステータスの更新、メモの追加を行うことができます。これらはすべて、プロジェクトリポジトリ内に存在するプレーンなMarkdownファイルによって管理されます。

コラボレーションの仕組み

共有サーバーはありません。バックログファイルはリポジトリ内の requirements/ に配置され、コードと一緒にコミットおよびバージョン管理されます。エージェント間、またはエージェントと人間の間のコラボレーションは、コードベースの他の部分と全く同じように、gitを通じて行われます。2つのエージェントが異なるストーリーを同時に更新した場合、gitがそれらをマージします。同じ行を編集した場合は、他のマージコンフリクトと同様に解決します。

このMCPサーバーは、各エージェントが個別に実行するローカルプロセスです。ファイルの読み書きを行い、残りはgitが処理します。

Related MCP server: Jira MCP

インストール

Releases ページからお使いのプラットフォーム用の最新バイナリをダウンロードし、$PATH の通った場所に配置してください。

または、Goがインストールされている場合は以下を実行してください：

go install github.com/corbym/backlog-mcp@latest

ソースからビルド

go mod tidy
go build -o backlog-mcp .

セットアップ

プロジェクトのルートディレクトリに requirements/ フォルダを初期化します：

./backlog-mcp init /path/to/your/project/requirements

これにより以下が作成されます：

requirements/
  requirements-index.md   # master index — source of truth for epics and story status
  backlog.md              # priority-ordered list of not-done stories
  epic-001-example/
    story-001.md          # example story file

requirements/ フォルダをリポジトリにコミットしてください。ファイルを編集して、独自のエピックやストーリーを追加します。

実行

./backlog-mcp

サーバーは、起動元の作業ディレクトリから相対的に requirements/ ディレクトリを探します。Claude Codeは作業ディレクトリをプロジェクトルートに設定するため、設定は不要です。

Claude Codeの設定（プロジェクト内の .claude/settings.json またはグローバルの ~/.claude/settings.json）：

{
  "mcpServers": {
    "backlog-mcp": {
      "command": "/path/to/backlog-mcp"
    }
  }
}

ツール

環境変数

ファイル形式

requirements-index.md — 見出しごとに1つのエピックセクション、テーブル行ごとに1つのストーリー：

## EPIC-001: Combat System — `draft`

| Story | Title | Status |
|-------|-------|--------|
| [STORY-001](./epic-001-combat-system/story-001.md) | Basic combat | draft |

backlog.md — 優先順位順の番号付きリスト：

1. **STORY-001** — Basic combat
2. **STORY-002** — Enemy AI *(in-progress)*

ストーリーファイルは BACKLOG_ROOT 配下の epic-NNN-slug/story-NNN.md に配置されます。

ステータスの値: draft, in-progress, done, blocked

注意事項

• ファイルの書き込みはアトミック（一時ファイル作成 + リネーム）であるため、書き込み中のクラッシュでファイルが破損することはありません。

• ファイルシステムが信頼できる唯一の情報源です。MCPサーバーがデータを所有することはありません。