README
¶
🚧 WORK IN PROGRESS — release coming soon!
swag2mcp bridges OpenAPI/Swagger/Postman API specifications with LLM agents via the Model Context Protocol (MCP).
- 16 MCP tools for discovering, inspecting, and invoking APIs
- Interactive TUI explorer with full-text search
- Zero integration code — just point to your specs and go
License
Licensed under the GNU Affero General Public License v3.0 (AGPL v3).
See LICENSE for the full license text.
SPDX-License-Identifier: AGPL-3.0-only
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
swag2mcp
command
|
|
|
swag2mcp-mock
command
|
|
|
internal
|
|
|
auth
Package auth provides authentication methods for API specifications.
|
Package auth provides authentication methods for API specifications. |
|
cache
Package cache provides disk-based caching for downloaded OpenAPI/Swagger spec files.
|
Package cache provides disk-based caching for downloaded OpenAPI/Swagger spec files. |
|
config
Package config provides YAML-based configuration loading, validation, and filtering.
|
Package config provides YAML-based configuration loading, validation, and filtering. |
|
env
Package env provides environment variable resolution for $(VAR_NAME) patterns and tilde expansion for file paths.
|
Package env provides environment variable resolution for $(VAR_NAME) patterns and tilde expansion for file paths. |
|
httpclient
Package httpclient provides a configurable HTTP client with support for proxy, cookies, headers, redirects, timeouts, and response size limits.
|
Package httpclient provides a configurable HTTP client with support for proxy, cookies, headers, redirects, timeouts, and response size limits. |
|
id
Package id provides deterministic MD5-based ID generation for specs, collections, tags, and endpoints.
|
Package id provides deterministic MD5-based ID generation for specs, collections, tags, and endpoints. |
|
index
Package index provides a full-text search index for API endpoints using the bluge library.
|
Package index provides a full-text search index for API endpoints using the bluge library. |
|
model
Package model defines the core domain types used across the application: Spec, Collection, Tag, Endpoint, and HTTPClientConfig.
|
Package model defines the core domain types used across the application: Spec, Collection, Tag, Endpoint, and HTTPClientConfig. |
|
ratelimit
Package ratelimit provides a per-endpoint rate limiter for API invoke operations.
|
Package ratelimit provides a per-endpoint rate limiter for API invoke operations. |
|
reader
Package reader provides streaming and path-based access to large JSON response files stored in the workspace.
|
Package reader provides streaming and path-based access to large JSON response files stored in the workspace. |
|
server/mockserver
Package mockserver provides mock HTTP servers for API specifications and authentication methods defined in the swag2mcp configuration.
|
Package mockserver provides mock HTTP servers for API specifications and authentication methods defined in the swag2mcp configuration. |
|
service
Package service implements the core business logic for swag2mcp.
|
Package service implements the core business logic for swag2mcp. |
|
spec
Package spec provides parsing of OpenAPI v2, OpenAPI v3, and Postman collection specifications.
|
Package spec provides parsing of OpenAPI v2, OpenAPI v3, and Postman collection specifications. |
|
workspace
Package workspace manages the workspace directory layout for swag2mcp.
|
Package workspace manages the workspace directory layout for swag2mcp. |
Click to show internal directories.
Click to hide internal directories.