
gremlin/mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
A Model Context Protocol (MCP) server for interacting with Gremlin's reliability management APIs.
Обзор
A Model Context Protocol (MCP) server for interacting with Gremlin's reliability management APIs.
README
Показан фрагмент оригинального README. Открыть оригинал.
Gremlin MCP Server
A Model Context Protocol (MCP) server for interacting with Gremlin’s reliability management APIs.
Overview
This MCP server provides access to Gremlin’s reliability testing and management capabilities, including:
- Service reliability management and monitoring
- Service dependency tracking
- Reliability experiments and testing
- Reliability reporting
- Usage and pricing reports
- Client (agent) and attack summaries
- Reliability test execution and queued run inspection
- Direct access to the Gremlin API
Installation
Prerequisites
- Node.js 22.15 or higher
- For the stdio server: a valid Gremlin API key
- For the hosted server: an OAuth client registered with the authorization server, see Deploying the hosted server
Two deployments
There are two entrypoints, with different authentication models, and they are deliberately separate programs rather than two modes of one:
src/main.ts (build/main.mjs) |
src/http.ts (build/http.mjs) |
|
|---|---|---|
| Transport | stdio | Streamable HTTP |
| Runs | Locally, next to your client | Hosted, Gremlin-operated |
| Users | One | Many, concurrently |
| Credential | A static API key from the environment | Each user’s own OAuth 2.0 access token |
This is the deployment customers run themselves, and the one Private Edition uses. It is
unaffected by the hosted server: the hosted path never falls back to a process-wide credential,
because nothing below apiKeyCredentialFromEnvironment knows GREMLIN_API_KEY exists.
Environment Variables
Grouped by which entrypoint reads them. Nothing in the stdio column is read by the hosted server, and nothing in the hosted column is read by the stdio server.
Both
| Variable | Required | Default | Description |
|---|---|---|---|
GREMLIN_SERVICE_URL |
No | https://api.gremlin.com/v1 |
Base URL for the Gremlin API, including the version prefix. Override to target a staging or self-hosted environment. |
GREMLIN_MCP_ENABLE_TELEMETRY |
No | (off) | 1 turns on OpenTelemetry metrics. See docs/telemetry.md. |
stdio — API key (build/main.mjs)
| Variable | Required | Default | Description |
|---|---|---|---|
GREMLIN_API_KEY |
Yes | — | Your Gremlin API key. The server exits immediately if this is missing. Not read by the hosted server. |
Hosted — OAuth (build/http.mjs)
| Variable | Required | Default | Description |
|---|
Установка
npx -y @gremlin/mcp-serverКонфигурация
{
"mcpServers": {
"gremlin": {
"command": "npx",
"args": ["-y", "@gremlin/mcp-server"],
"env": {
"GREMLIN_API_KEY": "your_gremlin_api_key_here"
}
}
}
}