@openapi-mcp/server
@sotayamashita
关于 @openapi-mcp/server
Powerful bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). Automatically converts any OpenAPI/Swagger API specification into MCP tools that can be used by AI assistants like Claude Desktop.
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"openapi-mcp-server-sotayamashita": {
"command": "bun",
"args": [
"run",
"src/index.ts",
"./path/to/openapi.yml"
]
}
}
}工具
未检测到工具
工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。
概览
What is @openapi-mcp/server?
@openapi-mcp/server is a bridge between OpenAPI specifications and AI assistants using the Model Context Protocol (MCP). It automatically converts any OpenAPI/Swagger API specification into MCP tools that AI assistants like Claude Desktop can use to interact with your APIs. It is for developers who want to make their REST APIs accessible to AI assistants without custom integrations.
How to use @openapi-mcp/server?
Clone the repository, install dependencies with bun install, then run bun run src/index.ts with a path to a local OpenAPI file or --api with a URL. Configure the required BASE_URL environment variable and optional HEADERS environment variable. Integrate with Claude Desktop or Cursor by adding the server to their MCP configuration.
Key features of @openapi-mcp/server
- Automatically converts OpenAPI/Swagger specs into MCP tools
- Supports OpenAPI v3.0.0 and v3.1.0
- Supports HTTP Basic, Bearer token, and header-based API key auth
- Works with local files or remote API specification URLs
- Configurable custom HTTP headers
Use cases of @openapi-mcp/server
- AI assistants performing real-world actions through your APIs
- Converting any REST API with an OpenAPI spec into AI-accessible tools
- Enabling Claude Desktop to interact with custom services without custom integrations
FAQ from @openapi-mcp/server
What OpenAPI versions and authentication methods are supported?
OpenAPI v3.0.0 and v3.1.0 are supported. Authentication includes HTTP Basic, static Bearer tokens, and header-based API keys. OpenAPI v2.0 (Swagger), OAuth 2.0, OpenID Connect, query param API keys, cookie auth, and dynamic JWT are not supported.
Is an operationId required for every operation?
Yes, every operation in your specification must have a unique operationId. The server will fail to start or process the specification if any operation is missing this field.
What are the runtime dependencies for @openapi-mcp/server?
The server requires Bun as the JavaScript runtime. Dependencies are installed via bun install. The server runs as a CLI process via MCP’s stdio transport.
How do I configure the server for use with Claude Desktop?
Add the server to your Claude Desktop configuration, specifying the bun command and path to the server script, along with the required BASE_URL environment variable and optional HEADERS for authentication.
开发工具 分类下的更多 MCP 服务器
Unity MCP (Server + Plugin)
IvanMurzakAI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr
nuxt-mcp / vite-plugin-mcp
antfuMCP server helping models to understand your Vite/Nuxt app better.
Deepwiki MCP Server
regenrek📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors
Serena
oraiosA powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent
TalkToFigma
sonnylazuardiTalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.
评论