English 中文

Below is a revised and polished version of the README.md for the mcp-sentry-custom project, formatted properly for clarity, correctness, and professionalism. It adheres to standard Markdown conventions and organizes the content into logical sections.

mcp-sentry-custom is a Model Context Protocol (MCP) server designed to retrieve and analyze issues from Sentry.io or self-hosted Sentry instances. This server provides tools to inspect error reports, stack traces, and other debugging information directly from your Sentry account.

1. get_sentry_issue

   • Description: Retrieve and analyze a specific Sentry issue by its ID or URL.
   • Input:
     • issue_id_or_url (string): The Sentry issue ID or full URL to analyze.
   • Returns: Detailed issue information, including:
     • Title
     • Issue ID
     • Status
     • Level
     • First seen timestamp
     • Last seen timestamp
     • Event count
     • Full stack trace

2. get_list_issues

   • Description: Retrieve and analyze a list of Sentry issues for a specific project.
   • Input:
     • project_slug (string): The Sentry project slug.
     • organization_slug (string): The Sentry organization slug.
   • Returns: A list of issues with details, including:
     • Title
     • Issue ID
     • Status
     • Level
     • First seen timestamp
     • Last seen timestamp
     • Event count
     • Basic issue information

1. sentry-issue
   • Description: Retrieve formatted issue details from Sentry for use in conversation context.
   • Input:
     • issue_id_or_url (string): The Sentry issue ID or URL.
   • Returns: Formatted issue details.

To install mcp-sentry-custom for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @javaDer/mcp-sentry-custom --client claude

When using uv, no specific installation is required. You can run mcp-sentry-custom directly with uvx:

uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

Alternatively, install mcp-sentry-custom via pip:

pip install mcp-sentry-custom

Or, with uv:

uv pip install -e .

After installation, run it as a script:

python -m mcp_sentry

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "sentry": {
      "command": "uvx",
      "args": [
        "mcp-sentry-custom",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

{
  "mcpServers": {
    "sentry": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "mcp/sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

{
  "mcpServers": {
    "sentry": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

Add the following to your settings.json in Zed:

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-sentry-custom",
          "--auth-token", "YOUR_SENTRY_TOKEN",
          "--project-slug", "YOUR_PROJECT_SLUG",
          "--organization-slug", "YOUR_ORGANIZATION_SLUG",
          "--sentry-url", "YOUR_SENTRY_URL"
        ]
      }
    }
  }
}

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ]
    }
  }
}

{
  "context_servers": {
    "mcp-sentry-custom": {
      "command": "python",
      "args": [
        "-m", "mcp_sentry",
        "--auth-token", "YOUR_SENTRY_TOKEN",
        "--project-slug", "YOUR_PROJECT_SLUG",
        "--organization-slug", "YOUR_ORGANIZATION_SLUG",
        "--sentry-url", "YOUR_SENTRY_URL"
      ],
      "env": {
        "PYTHONPATH": "path/to/mcp-sentry-custom/src"
      }
    }
  }
}

Use the MCP inspector to debug the server.

npx @modelcontextprotocol/inspector uvx mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

If you've installed the package in a specific directory or are developing it:

cd path/to/mcp-sentry-custom/src
npx @modelcontextprotocol/inspector uv run mcp-sentry-custom --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

Or, with a custom directory:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-sentry-custom/src run mcp_sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG --sentry-url YOUR_SENTRY_URL

This project is forked from:
https://github.com/modelcontextprotocol/servers/tree/main/src/sentry

This MCP server is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, see the LICENSE file in the project repository.

1. Formatting: Used proper Markdown headings, lists, and code blocks for readability.
2. Consistency: Standardized terminology (e.g., mcp_sentry vs. mcp-sentry-custom) and removed redundant <TEXT> and <JSON> tags.
3. Clarity: Rewrote sections like "Overview" and "Features" for conciseness and precision.
4. Completeness: Fixed incomplete sentences and ensured all configuration examples were properly structured.
5. Professional Tone: Adjusted wording to sound more formal and polished.

Let me know if you'd like further refinements!