FogBugz MCPサーバー

ClaudeなどのLLMを通じてFogBugzと連携するためのModel Context Protocol (MCP)サーバーです。起動時に自動的にバージョンを検出し、XML API (/api.asp) と JSON API (/f/api/0/jsonapi) の両方をサポートしています。オンプレミスおよびオンデマンドのFogBugzインストール環境で動作します。

概要

LLMが以下のFogBugz操作を実行できるようにします：

課題の作成、更新、解決、再オープン、クローズ
特定のユーザーへの課題の割り当て
イベント/コメント履歴を含む課題の検索と一覧表示
ユーザー、カテゴリ、プロジェクト、エリアの一覧表示
新規プロジェクトの作成
高度なユースケースのための汎用APIリクエスト

APIの自動検出

サーバーは起動時に、お使いのFogBugzインスタンスに適したAPIクライアントを自動的に選択します：

/api.xml にプローブを送信し、FogBugzのバージョン番号を読み取ります。
バージョンが9以上の場合、JSON API (/f/api/0/jsonapi) への接続を試みます。成功した場合は FogBugzJsonClient を使用します。
バージョンが9未満の場合、またはJSONエンドポイントに到達できない場合は、FogBugzXmlClient (XML API経由の /api.asp) にフォールバックします。

設定は不要で、適切なクライアントが自動的に選択されます。

FogBugzバージョン	使用されるAPI
≥ 9 (JSON API利用可能)	JSON API (`/f/api/0/jsonapi`)
< 9 または JSON API到達不可	XML API (`/api.asp`)

テキスト形式に関する注意: XML API経由でFogBugz 8.xに接続している場合、説明やコメントではプレーンテキストのみがサポートされます。HTMLやMarkdownはそのままの形式で保存・表示されます。

FogBugz APIトークンの取得

MCPサーバーをFogBugzで認証するにはAPIトークンが必要です。取得方法は2通りあります：

1. Web UI経由

Account & Settings → User Options に移動し、Create API Token リンクをクリックします。

公式ガイドを参照してください：Create API Token using the FogBugz UI

2. APIリクエスト経由

以下のリクエストを送信します（プレースホルダーを自分の値に置き換えてください）：

https://[your-fogbugz-server]/api.asp?cmd=logon&email=[your-email]&password=[your-password]

レスポンスにAPIトークンが含まれます。

公式ガイドを参照してください：Get an API Token using FogBugz API commands

インストール

ワンクリックインストール (Claude Desktop)

Releases ページから最新の .mcpb パッケージをダウンロードして開くと、Claude Desktopが自動的にサーバーをインストールおよび設定し、FogBugzのURLとAPIキーの入力を求めます。

手動インストール

git clone https://github.com/todevelopers/fogbugz-mcp.git
cd fogbugz-mcp
npm install
npm run build

MCPクライアントの設定

MCPクライアントの設定（例：Claude Desktopの claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": ["/absolute/path/to/fogbugz-mcp/dist/index.js"],
      "env": {
        "FOGBUGZ_URL": "https://your-fogbugz-server.com",
        "FOGBUGZ_API_KEY": "your-api-token"
      }
    }
  }
}

または、コマンドライン引数として認証情報を渡します：

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": [
        "/absolute/path/to/fogbugz-mcp/dist/index.js",
        "https://your-fogbugz-server.com",
        "your-api-token"
      ]
    }
  }
}

手動実行

# With command-line arguments
node dist/index.js https://your-fogbugz-server.com your-api-token

# With environment variables
FOGBUGZ_URL=https://your-fogbugz-server.com FOGBUGZ_API_KEY=your-api-token npm start

# With a .env file
cp .env.example .env   # fill in FOGBUGZ_URL and FOGBUGZ_API_KEY
npm start

開発

npm run dev    # run via ts-node (no build needed)
npm run build  # compile TypeScript to dist/
npm test       # run all Jest tests

MCPツール

課題管理

ツール	説明
`create_case`	新しい課題を作成する
`update_case`	既存の課題を更新する（タイトル、コメント、プロジェクト、エリア、マイルストーン、優先度）
`assign_case`	課題をユーザーに割り当てる
`resolve_case`	課題を解決（修正済み/完了としてマーク）する
`reopen_case`	解決済みまたはクローズ済みの課題を再オープンする
`close_case`	課題をクローズする

検索と表示

ツール	説明
`search_cases`	FogBugzクエリ構文を使用して検索する（例：`project:Website status:Active`）
`list_my_cases`	ユーザーに割り当てられた課題を一覧表示する（デフォルトは現在のユーザー）
`get_case`	イベント/コメント履歴を含む詳細な課題情報を取得する
`get_case_link`	課題への直接URLを取得する

参照データ

ツール	説明
`list_people`	ID、名前、メールアドレスを含む全ユーザーを一覧表示する
`list_categories`	課題カテゴリ（バグ、機能リクエストなど）を一覧表示する
`list_projects`	IDと名前を含む全アクティブプロジェクトを一覧表示する
`list_milestones`	マイルストーン/修正対象を一覧表示する（プロジェクト別も可）
`list_statuses`	解決フラグ付きの課題ステータスを一覧表示する（カテゴリ別も可）
`view_project`	詳細なプロジェクト情報を取得する
`view_area`	詳細なエリア情報を取得する
`create_project`	新しいプロジェクトを作成する

高度な機能

ツール

説明

api_request

専用ツールでカバーされていないコマンドのための汎用XML APIエスケープハッチ。

⚠️ 警告: 設定されたキーが許可するあらゆるAPIコマンドを実行できます。破壊的な操作（削除、ユーザー編集、一括変更など）も含まれます。

環境変数

変数	必須	説明
`FOGBUGZ_URL`	はい	FogBugzインスタンスのベースURL（例：`https://company.fogbugz.com`）
`FOGBUGZ_API_KEY`	はい	FogBugz APIトークン

互換性

FogBugz 8.8.53 (XML API) でテスト済みです。JSON APIサポートは仕様に基づいて実装されています。サーバーは起動時に使用するAPIを自動検出します。

謝辞

このプロジェクトは Sarasvati Akari Lara-Almeida によるオリジナルの成果に基づいています。基盤を提供していただきありがとうございます。

FogBugz