You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Signalhound includes a Model Context Protocol (MCP) integration that enables AI-powered analysis of failing tests and GitHub issues. The MCP system consists of two components:
65
+
66
+
### MCP Server
67
+
68
+
The MCP server runs automatically when you start the `abstract` command. It provides tools for querying GitHub project issues and is accessible at `http://localhost:8080/mcp` by default.
69
+
70
+
**Required Environment Variables:**
71
+
-`GITHUB_TOKEN` or `SIGNALHOUND_GITHUB_TOKEN` - GitHub Personal Access Token with `read:project` scope (required for the MCP server to query GitHub project issues)
72
+
73
+
**Features:**
74
+
- Lists all issues from the SIG Signal project board
75
+
- Filters issues by latest Kubernetes release version and FAILING status
76
+
- Returns issue details including number, title, body, state, and URL
77
+
78
+
### MCP Client
79
+
80
+
The MCP client is used by the TUI to analyze failing tests and compare them with existing GitHub issues using Anthropic's Claude AI.
81
+
82
+
**Required Environment Variables:**
83
+
-`ANTHROPIC_API_KEY` or `SIGNALHOUND_ANTHROPIC_API_KEY` - Anthropic API key for Claude AI analysis (required for AI-powered issue comparison)
84
+
-`MCP_SERVER_ENDPOINT` - MCP server endpoint URL (optional, defaults to `http://localhost:8080/mcp`)
85
+
86
+
**Features:**
87
+
- Compares currently failing tests with existing GitHub issues
88
+
- Identifies tests that don't have corresponding GitHub issues
89
+
- Provides AI-generated summaries and recommendations
90
+
91
+
### Complete Setup
92
+
93
+
To enable all MCP features, set the following environment variables:
94
+
95
+
```bash
96
+
# GitHub token for MCP server (to query project issues)
97
+
export GITHUB_TOKEN=<your-github-pat>
98
+
# or
99
+
export SIGNALHOUND_GITHUB_TOKEN=<your-github-pat>
100
+
101
+
# Anthropic API key for MCP client (for AI analysis)
5. Copy the key and set it as `ANTHROPIC_API_KEY` or `SIGNALHOUND_ANTHROPIC_API_KEY`
117
+
118
+
**Note:** The Anthropic API key is only required if you want to use the AI-powered analysis feature in the TUI. The MCP server will still work for listing issues without it, but the comparison and analysis features will not be available.
0 commit comments