gremlin/mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

6 stars 3 forks 质量 79 趋势 26Apache-2.0

Repository Install

gremlin/mcp 是从 https://github.com/gremlin/mcp. 导入的 MCP 服务器候选。

概览

gremlin/mcp 是从 https://github.com/gremlin/mcp. 导入的 MCP 服务器候选。

概述（AI 翻译）

一个用于与 Gremlin 可靠性管理 API 交互的模型上下文协议（MCP）服务器。

概述

该MCP服务器提供Gremlin的可靠性测试和管理能力，包括：

服务可靠性管理与监控
服务依赖跟踪
可靠性实验与测试
可靠性报告
使用和定价报告
客户端（代理）和攻击摘要
可靠性测试执行和队列运行检查
直接访问 Gremlin API

安装

先决条件

Node.js 18岁及以上
对于stdio服务器：有效的Gremlin API密钥
关于托管服务器：注册于授权服务器的OAuth客户端，参见部署托管服务器

两次部署

有两个入口点，使用不同的认证模式，且是刻意分开的程序而非两种模式：

	`src/main.ts`（`build/main.mjs`）	`src/http.ts`（`build/http.mjs`）
传输	标准	可流式HTTP
运行	本地，紧邻你的客户端	托管，Gremlin 运营
用户	一个	多个同时存在

本页由 AI 翻译，技术细节请以原文为准。

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

在 GitHub 查看完整 README

安装

npx -y @gremlin/mcp-server

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "gremlin": {
      "command": "npx",
      "args": ["-y", "@gremlin/mcp-server"],
      "env": {
        "GREMLIN_API_KEY": "your_gremlin_api_key_here"
      }
    }
  }
}