MCP Spectral
@mark-sivill
About MCP Spectral
Lints/Validates an OpenAPI specification
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"OpenAPI linting (Spectral)": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"marksivill/mcp-spectral"
]
}
}
}Tools
3lints OpenAPI specification
lints OpenAPI specification with Spectral ruleset
returns version of Spectral being used
Overview
What is MCP Spectral?
MCP Spectral is a Model Context Protocol (MCP) server that uses Spectral to lint OpenAPI specifications. It is designed for developers who want to validate and fix OpenAPI documents through large language model (LLM) tools such as Claude Desktop.
How to use MCP Spectral?
Install Docker and Claude Desktop, then add a Docker run command for marksivill/mcp-spectral to the claude_desktop_config.json file. Restart Claude Desktop to access three tools: lint_openapi, lint_openapi_with_ruleset, and spectral_version. Use natural language prompts to lint or build OpenAPI specs.
Key features of MCP Spectral
- Lints OpenAPI specifications using Spectral
- Lints OpenAPI specs with a custom Spectral ruleset
- Returns the installed Spectral version
- Runs inside a Docker container for easy setup
- Integrates with Claude Desktop via MCP
Use cases of MCP Spectral
- Validate an existing OpenAPI specification for errors
- Iteratively fix errors found in an OpenAPI document
- Build an OpenAPI specification from API documentation and revalidate
- Enforce custom linting rules on generated OpenAPI specs
FAQ from MCP Spectral
What tools does MCP Spectral offer?
It provides three tools: lint_openapi, lint_openapi_with_ruleset, and spectral_version.
What are the prerequisites to run MCP Spectral?
You need Docker installed on your machine and a host MCP client such as Claude Desktop.
How do I install and configure MCP Spectral?
Add a Docker run entry for marksivill/mcp-spectral to your claude_desktop_config.json file, then restart Claude Desktop. The Docker image will be pulled automatically.
Can MCP Spectral be used with other LLM tools besides Claude Desktop?
Yes, but the setup instructions assume Claude Desktop; adjust the configuration for your tool accordingly.
Where can I find more details about MCP Spectral?
See the Docker Hub page (marksivill/mcp-spectral) and the Spectral documentation at stoplight.io/open-source/spectral.
Frequently asked questions
What tools does MCP Spectral offer?
It provides three tools: `lint_openapi`, `lint_openapi_with_ruleset`, and `spectral_version`.
What are the prerequisites to run MCP Spectral?
You need Docker installed on your machine and a host MCP client such as Claude Desktop.
How do I install and configure MCP Spectral?
Add a Docker run entry for `marksivill/mcp-spectral` to your `claude_desktop_config.json` file, then restart Claude Desktop. The Docker image will be pulled automatically.
Can MCP Spectral be used with other LLM tools besides Claude Desktop?
Yes, but the setup instructions assume Claude Desktop; adjust the configuration for your tool accordingly.
Where can I find more details about MCP Spectral?
See the Docker Hub page (`marksivill/mcp-spectral`) and the Spectral documentation at stoplight.io/open-source/spectral.
Basic information
More Other MCP servers
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
Awesome Mlops
visengerA curated list of references for MLOps
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
Comments