Backlog

by katsuhirohonda

304 downloads
Not rated
GitHub

About

Integrates with Backlog to enable project overview generation, task management, and team collaboration analysis through API interactions and data summarization tools.

Details

Author
katsuhirohonda
Repository
katsuhirohonda/mcp-backlog-server
Downloads
304
Categories
Productivity, Developer Tools, Design, Workplace, AI, Project Management, Communication, Frontend, Other
Tags
#integration

- Access Backlog projects via structured backlog://project/[id] resources
- Retrieve user, space, project, issue, and wiki information
- Filter and paginate issue lists by status, assignee, and more
- Add comments to issues and read their details
- Summarize recent projects and analyze usage patterns
- Summarize project wiki pages with a dedicated prompt

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Backlog
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /path/to/mcp-backlog-server/build/index.js
    Environment
    • BACKLOG_API_KEY your-api-key
    • BACKLOG_SPACE_URL https://your-space.backlog.com

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with npm install, then build with npm run build. Configure the server in your Claude Desktop config file (claude_desktop_config.json) by specifying the path to the build output and setting two environment variables: BACKLOG_API_KEY and BACKLOG_SPACE_URL.

get_backlog_user

Retrieve the current Backlog user information.

get_backlog_space

Fetch the Backlog space information.

list_recent_projects

List recently viewed Backlog projects. Parameters: count (optional), order (optional).

get_project_issues

Retrieve issues for a project. Can filter by status, assignee, and pagination.

get_issue_detail

Get detailed information for a specific issue.

get_issue_comments

Fetch comments for an issue.

add_issue_comment

Add a comment to an issue.

get_issue_comment_count

Retrieve the number of comments for an issue.

get_issue_comment

Get detailed information for a specific comment.

get_wiki_page_list

Fetch a list of Wiki pages. Can filter by project or keyword.

get_wiki_page

Get detailed information for a specific Wiki page.

update_wiki_page

Update a Wiki page.

summarize_projects

Generate a summary of recently viewed Backlog projects.

analyze_backlog_usage

Analyze Backlog usage patterns based on user, space, and project data.

summarize_wiki_pages

Generate a summary of the project's Wiki pages.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "backlog": {
            "env": {
                "BACKLOG_API_KEY": "your-api-key",
                "BACKLOG_SPACE_URL": "https://your-space.backlog.com"
            },
            "args": [
                "/path/to/mcp-backlog-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_SPACE_URL": "https://your-space.backlog.com"
    },
    "args": [
        "/path/to/mcp-backlog-server/build/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_SPACE_URL": "https://your-space.backlog.com"
    },
    "args": [
        "/path/to/mcp-backlog-server/build/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_SPACE_URL": "https://your-space.backlog.com"
    },
    "args": [
        "/path/to/mcp-backlog-server/build/index.js"
    ],
    "command": "node"
}

mcp-backlog-server

Backlog MCP Server

これはBacklogとModel Context Protocol (MCP)を統合するTypeScriptベースのサーバーです。以下のMCPの主要概念を実装しています:

- Backlogプロジェクトを表すリソース(URIとメタデータを含む)
- Backlog APIと対話するためのツール
- Backlogデータの要約と分析を生成するためのプロンプト

機能

リソース

- backlog://project/[id] URIを通じてBacklogプロジェクトにアクセス - 各プロジェクトリソースにはプロジェクトのメタデータと詳細情報が含まれる - 構造化データアクセスのためのJSON形式リソース - プロジェクト内の課題(イシュー)へのアクセス - プロジェクト内のWikiページへのアクセス

ツール

- get_backlog_user - 現在のBacklogユーザー情報を取得 - get_backlog_space - Backlogスペース情報を取得 - list_recent_projects - 最近閲覧したBacklogプロジェクトを一覧表示 - 件数と並び順を設定可能 - get_project_issues - プロジェクトの課題を取得 - ステータス、担当者、ページネーションなどでフィルタリング可能 - get_issue_detail - 特定の課題の詳細情報を取得 - get_issue_comments - 課題のコメントを取得 - add_issue_comment - 課題にコメントを追加 - get_issue_comment_count - 課題のコメント数を取得 - get_issue_comment - 特定のコメントの詳細情報を取得 - get_wiki_page_list - Wikiページの一覧を取得 - プロジェクトやキーワードでフィルタリング可能 - get_wiki_page - 特定のWikiページの詳細情報を取得 - update_wiki_page - Wikiページを更新

プロンプト

- summarize_projects - 最近閲覧したBacklogプロジェクトの要約を生成 - analyze_backlog_usage - ユーザー、スペース、プロジェクトデータに基づくBacklog使用パターンの分析 - summarize_wiki_pages - プロジェクトのWikiページの要約を生成

必要条件

- API アクセス権を持つ Backlog アカウント
- 環境変数:
- BACKLOG_API_KEY: Backlog API キー
- BACKLOG_SPACE_URL: Backlog スペース URL (例: https://your-space.backlog.com)

開発

依存関係のインストール:

npm install

サーバーのビルド:

npm run build

自動再ビルドによる開発:

npm run watch

インストール

Claude Desktopで使用するには、サーバー設定を追加します:

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.