Bugsink MCP Server

MCP (Model Context Protocol) server for querying Bugsink error tracking. Allows Claude Code to directly access your error reports.

Features

• List all projects
• List issues (errors) for a project
• Get issue details
• List events (error occurrences)
• Get full event data
• Get formatted stacktraces

Quick Start

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "bugsink": {
      "command": "npx",
      "args": ["-y", "bugsink-mcp-server"],
      "env": {
        "BUGSINK_URL": "https://your-bugsink-instance.com",
        "BUGSINK_TOKEN": "your-api-token-here"
      }
    }
  }
}

Then restart Claude Code.

Installation (Alternative)

# Global install
npm install -g bugsink-mcp-server

# Then use in settings:
{
  "mcpServers": {
    "bugsink": {
      "command": "bugsink-mcp",
      "env": {
        "BUGSINK_URL": "https://your-bugsink-instance.com",
        "BUGSINK_TOKEN": "your-api-token-here"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | list_projects | List all Bugsink projects | | list_issues | List issues for a project (sorted by last_seen) | | get_issue | Get details of a specific issue | | list_events | List events (occurrences) for an issue | | get_event | Get full event data including context | | get_stacktrace | Get formatted stacktrace markdown |

Usage Examples

Once configured, you can ask Claude:

• "Show me recent errors from Bugsink"
• "Get the stacktrace for the latest error"
• "What errors happened in project 3?"

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | BUGSINK_TOKEN | Yes | - | Your Bugsink API token | | BUGSINK_URL | No | https://bug.sols.mk:8000 | Bugsink instance URL |

Docker Usage (optional)

Build and run with Docker:

docker build -t bugsink-mcp .
docker run -e BUGSINK_TOKEN=your-token bugsink-mcp

Development

# Install dependencies
npm install

# Run in watch mode
npm run dev

# Test manually
BUGSINK_TOKEN=your-token node src/index.js

License

MIT