mcp-sentry: A Sentry MCP Server

A Model Context Protocol server for retrieving and analyzing issues from Sentry.io. This server provides tools to inspect error reports, stacktraces, and other debugging information from your Sentry account.

Overview

This MCP server allows AI assistants to access and analyze Sentry issues, providing detailed information about errors in your applications.

Tools

1. get_sentry_issue

   Retrieve and analyze a Sentry issue by ID or URL

   Input:

   • issue_id_or_url (string): Sentry issue ID or URL to analyze

   Returns: Issue details including:

   • Title
   • Issue ID
   • Status
   • Level
   • First seen timestamp
   • Last seen timestamp
   • Event count
   • Full stacktrace

Prompts

1. sentry-issue

   Retrieve issue details from Sentry

   Input:

   • issue_id_or_url (string): Sentry issue ID or URL

   Returns: Formatted issue details as conversation context

Installation

Prerequisites

• Node.js 14 or later
• A Sentry account with an authentication token

Using npm

npm install -g mcp-sentry

After installation, you can run it as a command:

mcp-sentry --auth-token YOUR_SENTRY_TOKEN

Or with the environment variable:

SENTRY_TOKEN=YOUR_SENTRY_TOKEN mcp-sentry

Using npx (without installation)

npx mcp-sentry --auth-token YOUR_SENTRY_TOKEN

Development

Project Structure

mcp-sentry/
├── src/
│   ├── index.ts           # Main entry point
│   ├── server.ts          # MCP server implementation
│   ├── sentry-client.ts   # Sentry API client
│   ├── models.ts          # Data models
│   ├── utils.ts           # Utility functions
│   └── types/             # Type definitions
├── build/                 # Compiled JavaScript files (included in the repository for direct npx execution)
├── package.json
├── tsconfig.json
└── README.md

Building

npm run build

Note: Unlike typical Node.js projects, the build directory is committed to this repository to support direct npx execution without requiring users to build the project themselves.

Running in Development Mode

npm run dev -- --auth-token YOUR_SENTRY_TOKEN

Authentication

This server requires a Sentry authentication token to access the Sentry API. You can provide this token in two ways:

1. Using the --auth-token command-line option:

   mcp-sentry --auth-token YOUR_SENTRY_TOKEN
   

2. Using the SENTRY_TOKEN environment variable:

   SENTRY_TOKEN=YOUR_SENTRY_TOKEN mcp-sentry
   

Usage with Claude Desktop

Add this to your Claude Desktop configuration:

"mcpServers": {
  "sentry": {
    "command": "mcp-sentry",
    "args": ["--auth-token", "YOUR_SENTRY_TOKEN"]
  }
}

Usage with Zed

Add to your Zed settings.json:

"context_servers": [
  "mcp-server-sentry": {
    "command": {
      "path": "mcp-sentry",
      "args": ["--auth-token", "YOUR_SENTRY_TOKEN"]
    }
  }
],

Debugging

You can use the MCP inspector to debug the server:

npx @modelcontextprotocol/inspector mcp-sentry --auth-token YOUR_SENTRY_TOKEN

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.