Backlog MCP Server 61l

Backlog MCP Server是一個用於與Backlog API交互的模型上下文協議服務器，提供項目管理、問題跟蹤、Wiki頁面管理等功能，支持通過AI代理操作Backlog平臺。

開發者工具版本控制 #項目管理 #API集成 #AI代理 #協作工具本地 .TypeScript

評分 : 2分

下載量 : 13

更新時間 : 2025-04-23

什麼是Backlog MCP服務器？

Backlog MCP服務器是一個通過AI代理（如Claude Desktop、Cline等）管理Backlog項目、問題、維基頁面等功能的工具。

如何使用Backlog MCP服務器？

您可以通過Docker或手動安裝方式配置MCP服務器，並使用其提供的多種工具來管理Backlog項目。

適用場景

適用於需要高效管理Backlog項目的開發團隊，尤其是集成AI代理的協作場景。

主要功能

項目管理支持創建、讀取、更新和刪除Backlog項目。

問題跟蹤創建、更新、刪除問題以及查看問題列表。

維基頁面管理管理Backlog中的維基頁面。

Git倉庫管理管理與Backlog項目相關的Git倉庫。

優勢與侷限性

優勢

與Backlog API深度集成

支持多種AI代理工具

優化響應性能

侷限性

需要Backlog賬戶及API訪問權限

對網絡環境有一定依賴

如何使用

安裝Docker

確保您的系統已安裝Docker。

配置MCP服務器

根據Backlog賬戶信息設置環境變量。

啟動MCP服務器

運行Docker容器或本地腳本。

使用案例

列出所有項目請求顯示當前Backlog空間內的所有項目。

創建新問題在指定項目中創建一個新的問題。

常見問題

如何安裝MCP服務器？

是否支持多語言描述？

相關資源

GitHub 代碼庫

開源代碼倉庫。

官方文檔

詳細的用戶指南。

安裝

複製以下命令到你的Client進行配置

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "-e", "MAX_TOKENS",
        "-e", "OPTIMIZE_RESPONSE",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key",
        "MAX_TOKENS": "10000",
        "OPTIMIZE_RESPONSE": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "--pull", "always",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

{
    "mcpServers": {
      "backlog": {
        "command": "node",
        "args": [
          "your-repository-location/build/index.js"
        ],
        "env": {
          "BACKLOG_DOMAIN": "your-domain.backlog.com",
          "BACKLOG_API_KEY": "your-api-key"
        }
      }
    }
  }

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "-v", "/yourcurrentdir/.backlog-mcp-serverrc.json:/root/.backlog-mcp-serverrc.json:ro",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "-e", "BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION"
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "An alternative description"
      }
    }
  }
}

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🚀 backlog - MCP 服務器工具

backlog - MCP 服務器工具是一款功能強大的項目管理輔助工具，它能幫助用戶快速創建項目、高效管理問題和 Wiki 內容，還支持文件存儲和集成開發。同時，工具提供了靈活的配置方式和國際化支持，滿足不同用戶的多樣化需求。

🚀 快速開始

您可以使用 backlog - MCP 服務器快速創建新的項目，還能利用其豐富功能對項目進行管理和開發。

✨ 主要特性

創建項目：您可以使用 backlog - MCP 服務器快速創建新的項目。
問題跟蹤：該工具支持通過 CSV 文件或直接 API 請求批量導入和管理問題。
Wiki 管理：能夠通過 CSV 文件或 REST API 導入和更新 Wiki 內容。
文件存儲：提供將文件上傳到 Backlog 的功能，並且支持對上傳的文件進行管理。
集成開發：該工具為開發者提供了豐富的接口，方便與其他系統進行深度集成。

📦 安裝指南

以下是使用 Docker 運行 backlog - MCP 服務器的示例配置：

docker run -i --rm ghcr.io/nulab/backlog-mcp-server node build/index.js

如果您需要自定義配置，可以參考以下 JSON 格式的配置文件：

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

💻 使用示例

基礎用法

工具描述的國際化 - 使用配置文件

在您的用戶主目錄下創建或修改 .backlog-mcp-serverrc.json 文件，添加以下內容以覆蓋工具描述：

{
  "TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "添加問題評論",
  "TOOL_CREATE_PROJECT_DESCRIPTION": "創建新項目"
}

支持的文件格式包括：.json、.yaml 和 .yml。

工具描述的國際化 - 使用環境變量

您還可以通過設置環境變量來覆蓋工具描述，例如：

BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION=添加問題評論
BACKLOG_MCP_TOOL_CREATE_PROJECT_DESCRIPTION=創建新項目

這些環境變量需要以 BACKLOG_MCP_ 為前綴，並且使用大寫字母。

高級用法

運行測試

npm test

添加新工具

在 src/tools/ 目錄下創建新的工具文件，遵循現有工具的命名規範。
創建對應的測試文件。
將新工具添加到 src/tools/tools.ts 文件中。
構建並測試您的更改。

命令行選項使用

--export-translations：導出所有翻譯鍵和值
--optimize-response：啟用 GraphQL 風格字段選擇
--max-tokens=NUMBER：設置響應的最大令牌限制

示例：

node build/index.js --optimize-response --max-tokens=100000

📚 詳細文檔

工具描述的國際化（i18n）

為了滿足不同語言需求，您可以自定義工具描述。具體方法如下：

使用配置文件：在您的用戶主目錄下創建或修改 .backlog-mcp-serverrc.json 文件，添加相應內容以覆蓋工具描述，支持的文件格式包括：.json、.yaml 和 .yml。
使用環境變量：通過設置以 BACKLOG_MCP_ 為前綴且使用大寫字母的環境變量來覆蓋工具描述。