FogBugz MCP サーバー

Claude などの言語学習モデル (LLM) を通じて FogBugz と対話するためのモデルコンテキストプロトコル (MCP) サーバー。

概要

このサーバーにより、LLM は FogBugz に対して次のようなさまざまな操作を実行できます。

オプションの添付ファイル付きの新しい問題/ケースの作成
既存のケースの更新（プロジェクト、エリア、マイルストーン、優先度の変更）
特定のユーザーにケースを割り当てる
ユーザーのオープンケースの一覧表示
特定のケースへの直接リンクを取得する
さまざまな基準でケースを検索する

サーバーはモデルコンテキストプロトコル (MCP)仕様を実装しており、MCP 互換の LLM クライアントで使用できます。

プロジェクトの背景

このプロジェクトは、OpenAIのo3-mini-highモデルの支援を受けて開始され、包括的な開発計画が作成されました（リポジトリのDEVELOPMENT-PLAN.mdを参照）。この計画では、TypeScriptでFogBugz MCPサーバーを構築するためのアーキテクチャ、ツール、実装の詳細が概説されています。

詳細な仕様は開発チームにとって青写真となり、プロジェクトの設計・計画の初期段階においてAIがどのように効果的に支援できるかを示しました。このプロジェクトは、AI支援開発の好例であると同時に、MCPプロトコルを通じてAIの能力を強化するツールでもあります。

インストール

# Install from npm
npm install -g fogbugz-mcp

# Or use directly with npx
npx fogbugz-mcp <fogbugz-url> <api-key>

使用法

基本的な使い方

# Run with command line arguments
fogbugz-mcp https://yourcompany.fogbugz.com your-api-key

# Or use environment variables
export FOGBUGZ_URL=https://yourcompany.fogbugz.com
export TEST_FOGBUGZ_API_KEY=your-api-key
fogbugz-mcp

発達

# Clone the repository
git clone https://github.com/yourusername/fogbugz-mcp.git
cd fogbugz-mcp

# Install dependencies
npm install

# Create a .env file with your FogBugz credentials
echo "FOGBUGZ_URL=https://yourcompany.fogbugz.com" > .env
echo "TEST_FOGBUGZ_API_KEY=your-api-key" >> .env

# Run API explorer to test FogBugz API
npm run explore

# Run the development version of the server
npm run dev

# Run tests
npm test

# Build the project
npm run build

APIエクスプローラー

このプロジェクトには、FogBugz API エンドポイントを直接テストするための API エクスプローラーツールが含まれています。

# Run all API tests
npm run explore

# Run a specific test (by index)
npm run explore 0  # Run the first test

MCPツール

このサーバーは、LLM 用に次の MCP ツールを提供します。

fogbugz_create_case - 新しい FogBugz ケースを作成する
fogbugz_update_case - 既存のケースのフィールドを更新する
fogbugz_assign_case - 特定のユーザーにケースを割り当てる
fogbugz_list_my_cases - 特定のユーザーに割り当てられたケースを一覧表示する
fogbugz_search_cases - クエリ文字列を使用してケースを検索する
fogbugz_get_case_link - 特定のケースへの直接リンクを取得する

ライセンス

ISC