fogbugz-mcp

FogBugz MCP Server

A Model Context Protocol (MCP) server for interacting with FogBugz through Language Learning Models (LLMs) such as Claude.

Overview

This server allows LLMs to perform various operations on FogBugz including:

• Creating new issues/cases with optional attachments
• Updating existing cases (changing project, area, milestone, priority)
• Assigning cases to specific users
• Listing a user's open cases
• Getting direct links to specific cases
• Searching for cases by various criteria

The server implements the Model Context Protocol (MCP) specification, allowing it to be used by any MCP-compatible LLM client.

Project Background

This project was initiated with the help of OpenAI's o3-mini-high model, which generated a comprehensive development plan (see DEVELOPMENT-PLAN.md in the repository). The plan outlined the architecture, tools, and implementation details for building a FogBugz MCP server in TypeScript.

The detailed specification served as a blueprint for the development team, demonstrating how AI can effectively assist in the early phases of project design and planning. This project is both an example of AI-assisted development and a tool that enhances AI capabilities through the MCP protocol.

Installation

# Install from npm
npm install -g fogbugz-mcp

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

Usage

Basic Usage

# 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

Development

# 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 Explorer

The project includes an API explorer tool for testing FogBugz API endpoints directly:

# Run all API tests
npm run explore

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

MCP Tools

This server provides the following MCP tools for LLMs:

• fogbugz_create_case - Create a new FogBugz case
• fogbugz_update_case - Update an existing case's fields
• fogbugz_assign_case - Assign a case to a specific user
• fogbugz_list_my_cases - List cases assigned to a specific user
• fogbugz_search_cases - Search for cases using a query string
• fogbugz_get_case_link - Get a direct link to a specific case

License

ISC