fastmcp-backlog-server

v1.0.6

Published

10 months ago

BacklogのAPIと連携するModel Context Protocol (MCP) サーバーです。このプロジェクトは、AI アシスタントがBacklogのプロジェクト管理システムと対話できるようにするためのインターフェースを提供します。

0High
0Medium
0Low

takachaa

FastMCP Backlog Server

概要

このサーバーはFastMCPフレームワークを使用して構築されており、backlog-mcp-serverを参考に作成されています。MCPプロトコルを通じて、AIアシスタントがBacklogの様々な機能にアクセスできるようになります。

機能

プロジェクト情報の取得
課題（イシュー）の取得・作成
Wiki ページの取得・作成
Git リポジトリ情報の取得

必要条件

Node.js 18以上
Backlogアカウントとアクセス権
Backlog APIキー

インストールと使用方法

このパッケージはnpmに公開されており、インストールせずにnpxコマンドで直接実行することができます：

# 環境変数を設定してサーバーを起動
BACKLOG_API_KEY=あなたのAPIキー BACKLOG_SPACE_ID=あなたのスペースID npx fastmcp-backlog-server

または、グローバルにインストールして使用することもできます：

# グローバルにインストール
npm install -g fastmcp-backlog-server

# 環境変数を設定してサーバーを起動
BACKLOG_API_KEY=あなたのAPIキー BACKLOG_SPACE_ID=あなたのスペースID fastmcp-backlog-server

環境設定

以下の環境変数を設定する必要があります：

BACKLOG_API_KEY: BacklogのAPIキー
BACKLOG_SPACE_ID: BacklogのスペースID
BACKLOG_BASE_URL (オプション): カスタムBacklog API URL。指定しない場合は https://{BACKLOG_SPACE_ID}.backlog.com/api/v2 が使用されます

環境変数は直接コマンドラインで指定するか、.envファイルを使用することができます。.envファイルを使用する場合は、以下のようにファイルを作成し、サーバー起動時に読み込まれるようにします：

BACKLOG_API_KEY=あなたのBacklogAPIキー
BACKLOG_SPACE_ID=あなたのBacklogスペースID
# 以下は任意です
# BACKLOG_BASE_URL=カスタムBacklog API URL

.envファイルを使用する場合は、以下のように起動します：

npx -r dotenv/config fastmcp-backlog-server

Claude や GPT との連携

このMCPサーバーはClaude DesktopやMCPに対応したその他のAIアシスタントと連携することができます。

Claude Desktopと連携する場合は、以下の設定を行ってください：

Claude Desktopの設定ファイルを開く
以下の設定を追加：
- BACKLOG_BASE_URLも必要であれば追加する

{
  "mcpServers": {
    "backlog-mcp-server": {
      "command": "npx",
      "args": [
        "fastmcp-backlog-server"
      ],
      "env": {
        "BACKLOG_API_KEY": "あなたのBacklogAPIキー",
        "BACKLOG_SPACE_ID": "あなたのBacklogスペースID"
      }
    }
  }
}

利用可能なツール

このMCPサーバーは以下のツールを提供します：

| ツール名 | 説明 | |----------|------| | backlog_get_projects | プロジェクト一覧を取得します | | backlog_get_project | 指定したプロジェクトの詳細を取得します | | backlog_get_issues | 課題（イシュー）一覧を取得します | | backlog_get_issue | 指定した課題の詳細を取得します | | backlog_add_issue | 新しい課題を作成します | | backlog_get_wikis | Wiki一覧を取得します | | backlog_get_wiki | 指定したWikiの詳細を取得します | | backlog_add_wiki | 新しいWikiページを作成します | | backlog_get_git_repositories | Gitリポジトリ一覧を取得します | | backlog_get_git_repository | 指定したGitリポジトリの詳細を取得します

ライセンス

このプロジェクトはMIT Licenseの下で公開されています。

謝辞

このプロジェクトは以下のプロジェクトを参考にしています：

FastMCP - MCPサーバー構築用TypeScriptフレームワーク
backlog-mcp-server - Backlog用MCPサーバーの実装例

免責事項

このプロジェクトはBacklog公式のプロダクトではありません。Backlogの利用規約に従って使用してください。

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme