APILinter MCP Server

@jbovet

代码仓库

基本信息

分类

其他

许可证

MIT license

传输方式

stdio

作者

jbovet

提交者

Jose Bovet Derpich

关于 APILinter MCP Server

The OpenAPI MCP Server powers seamless communication using agents and REST APIs by implementing the Model Context Protocol

APILinter MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "api-linter": {
      "command": "docker-compose",
      "args": [
        "-f",
        "/path/to/your/project/docker-compose.yml",
        "up",
        "mcp-server",
        "--build"
      ],
      "cwd": "/path/to/your/project",
      "env": {
        "APILINTER_URL": "http://localhost:8000"
      }
    }
  }
}

APILinter MCP Server 工具

Validates an API specification (OpenAPI/Swagger) against API Linter rules

Lists all available API Linter rules

Calculates the quality score of an API specification

Retrieves the categories of API Linter rules

概览

What is APILinter MCP Server?

APILinter MCP Server enables seamless communication between LLMs and REST APIs by implementing the Model Context Protocol (MCP). It integrates with the Zally API Linter to validate and analyze OpenAPI/Swagger specifications, providing tools for linting, quality scoring, and design review.

How to use APILinter MCP Server?

Clone the repository, install dependencies with npm install, and build with npm run build. Configure environment variables (e.g., PORT, APILINTER_URL), run Zally server separately, then start the MCP server with npm run dev. Use the provided tools (validate_api_specification, list_rules, etc.) and prompts (api_design_review) via an MCP client or the included example interactive client (npx tsx example/simpleStreamableHttp.ts).

Key features of APILinter MCP Server

Implements MCP Streamable HTTP transport (stateless)
Provides five tools for API linting and quality scoring
Includes pre-configured api_design_review prompt
Supports retry logic and circuit breaker patterns
Structured logging, metrics, health checks, and error handling
Input validation and origin validation for security

Use cases of APILinter MCP Server

Validate an API specification against Zally linting rules
List available linting rules filtered by active status
Calculate a quality score for an OpenAPI specification
Retrieve rule categories from the API linter
Obtain structured design feedback on an API specification

常见问题

What runtime dependencies does it require?

It requires Node.js, npm, and a running Zally server (see Zally’s quick start guide).

How does it handle service failures?

It implements retry logic (configurable via `RETRY_COUNT`) and a circuit breaker (threshold configurable via `CIRCUIT_BREAKER_THRESHOLD`) to gracefully handle transient failures.

What transport protocols are supported?

Only MCP Streamable HTTP transport is implemented. SSE and STDIO transports are not planned.

Where does API specification data live?

Data is sent to the API linter service (configured via `APILINTER_URL`) for validation; the server itself is stateless and does not persist specification content.

Is authentication supported?

MCP authentication is not implemented, as the README states it is "not necessary". Origin validation (localhost only in development) is used for security.

其他分类下的更多 MCP 服务器

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K