FogBugz MCP Server

by akari2600

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

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

  1. Overview
    1. Project Background
      1. Installation
        1. Usage
          1. Basic Usage
          2. Development
        2. API Explorer
          1. MCP Tools
            1. License

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
                Last updated -
                12
                Python
                MIT License
                • Linux
                • Apple
              • -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that integrates Claude with Blender, enabling users to analyze and interact with IFC (Industry Foundation Classes) building models through natural language commands.
                Last updated -
                5
                Python
                MIT License
                • Apple
              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that bridges AI assistants like Claude with Wordware's specialized agent capabilities, allowing dynamic loading and access to any Wordware flow through a standardized interface.
                Last updated -
                Python
              • -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that enables large language models to interact with Linear's issue tracking system, allowing management of issues, projects, teams, and other Linear resources.
                Last updated -
                TypeScript
                MIT License
                • Apple

              View all related MCP servers

              ID: cbqrmh240t