README.md.original•2.34 kB
# AppSignal MCP Server
An MCP (Model Context Protocol) server for connecting to AppSignal and fetching incident information.
## Features
- Connect to AppSignal's GraphQL API
- Fetch incident details and samples
- List and search incidents
- Provide prompts for analyzing incidents and suggesting fixes
## Prerequisites
- Node.js 18 or higher
- AppSignal API token and App ID
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/mcp-appsignal.git
cd mcp-appsignal
```
2. Install dependencies:
```bash
npm install
```
3. Create a `.env` file with your AppSignal credentials:
```
APPSIGNAL_API_TOKEN=your-api-token
APPSIGNAL_APP_ID=your-app-id
```
## Usage
### Running the MCP Server
```bash
node src/index.js
```
### Integrating with Cursor
To use this MCP server with Cursor, add the following configuration to your Cursor settings:
```json
{
"mcp": {
"servers": {
"appsignal": {
"command": "node",
"args": ["/path/to/mcp-appsignal/src/index.js"],
"env": {
"APPSIGNAL_API_TOKEN": "your-api-token",
"APPSIGNAL_APP_ID": "your-app-id"
}
}
}
}
}
```
Replace `/path/to/mcp-appsignal` with the actual path to your repository.
## MCP Resources
The server exposes the following 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
The server provides the following tools:
- `getIncident` - Fetch an incident by number
- `getIncidentSample` - Fetch a sample for a specific incident
- `listIncidents` - List incidents with optional filtering
## MCP Prompts
The server offers the following prompts:
- `analyzeIncident` - Analyze an incident and provide insights
- `suggestFixes` - Suggest fixes for an error
## Testing with MCP Inspector
You can test the server using the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector):
1. Install the MCP Inspector:
```bash
npm install -g @modelcontextprotocol/inspector
```
2. Run the inspector and point it to your server:
```bash
mcp-inspector --command "node src/index.js"
```
## License
MIT