MCP Appsignal

🚀 mcp-appsignal

An MCP (Model Context Protocol) server designed to connect to AppSignal and retrieve incident information, streamlining the process of handling and analyzing incidents.

🚀 Quick Start

This section provides a quick guide on how to get started with mcp-appsignal. You'll learn how to install the tool and use it both from the command line and within Cursor.

📦 Installation

You can install mcp-appsignal globally using npm:

npm install -g mcp-appsignal

💻 Usage Examples

Basic Usage - Command Line

To use mcp-appsignal from the command line, you first need to set the necessary environment variables and then start the server:

# Set environment variables
export APPSIGNAL_API_TOKEN=your-api-token
export APPSIGNAL_APP_ID=your-app-id

# Run the server
mcp-appsignal

Advanced Usage - With Cursor

If you want to use mcp-appsignal within Cursor, you need to add the following configuration to your Cursor settings:

{
  "mcp": {
    "servers": {
      "appsignal": {
        "command": "npx",
        "args": ["mcp-appsignal"],
        "env": {
          "APPSIGNAL_API_TOKEN": "your-api-token",
          "APPSIGNAL_APP_ID": "your-app-id"
        }
      }
    }
  }
}

✨ Features

• Connect to AppSignal's GraphQL API
• Fetch incident details and samples
• List and search incidents
• Provide prompts for analyzing incidents and suggesting fixes

📚 Documentation

MCP Resources

• appsignal://incident/{incidentNumber} - Get details about a specific incident
• appsignal://incident/{incidentNumber}/sample/{sampleId?} - Get a sample for a specific incident
• appsignal://incidents - List all incidents

MCP Tools

• getIncident - Fetch an incident by number
• getIncidentSample - Fetch a sample for a specific incident
• listIncidents - List incidents with optional filtering

MCP Prompts

• analyzeIncident - Analyze an incident and provide insights
• suggestFixes - Suggest fixes for an error

📄 License

This project is licensed under the MIT license.