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
- 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
- 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:
Using the --auth-token command-line option:
mcp-sentry --auth-token YOUR_SENTRY_TOKEN
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.
