FogBugz MCP Server
A Model Context Protocol server that enables Language Learning Models to interact with FogBugz, allowing operations like creating and updating issues, assigning cases, listing open cases, and searching through natural language.
README Documentation
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 casefogbugz_update_case
- Update an existing case's fieldsfogbugz_assign_case
- Assign a case to a specific userfogbugz_list_my_cases
- List cases assigned to a specific userfogbugz_search_cases
- Search for cases using a query stringfogbugz_get_case_link
- Get a direct link to a specific case
License
ISC