Swagger MCP Server
About
An example MCP server for deployment on Cloudflare Workers without authentication.
Details
- Author
- acceleronix
- Categories
- Developer Tools, Cloud Service, Infrastructure, Other
Jump to
Setup
Install Swagger MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/acceleronix/swagger-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
Acceleronix OpenAPI Swagger Doc MCP Server
A comprehensive Model Context Protocol (MCP) server that provides seamless access to32 OpenAPIsfrom theAcceleronix Developer Center. Built on Cloudflare Workers with intelligent tool management and Bearer token authentication.
- 32 Acceleronix PaaS OpenAPIs: Comprehensive coverage of device management, data storage, family services, and more
- Smart Tool Management: Intelligent load balancing with 3-8 tools per API (~100 tools total)
- Multi-Tier Architecture: EndUser, Enterprise, and Open API access levels
- Bearer Token Auth: Unified authentication across all APIs
- Real-time Access: Deployed on Cloudflare Workers for global low-latency access
- Claude Integration: Direct integration with Claude Desktop and AI Playground
Core Device Management(18 Enabled APIs)
- Device Manager (Enterprise)- Device lifecycle and configuration management
- Device Shadow (Enterprise)- Device state synchronization and shadow operations
- Binding Service (EndUser/Enterprise)- Device binding and user association
- DeviceGroup Service (EndUser)- Group management and batch operations
- App Service (EndUser)- Application management and deployment
- Family Service (EndUser)- Multi-user family account management
- EndUser Service (EndUser)- User profile and account operations
- Product Management (Enterprise)- Product catalog and lifecycle
- Data Storage (EndUser)- Time-series data storage and retrieval
- Weather Service (EndUser)- Weather data integration
- Rule Engine (EndUser)- Event processing and automation rules
- Category Management (EndUser)- Device categorization and taxonomy
- OTA Service (EndUser)- Over-the-air firmware updates
- Thing Specification Language (Enterprise)- Device model definitions
- Matter Service (EndUser)- Matter protocol integration
- I18n Service (EndUser)- Internationalization and localization
- Global Bootstrap (Open)- Platform initialization services
Additional APIs(14 Available, Currently Disabled)
- Mail Service, Mobile Push, OEM App, Portal Service, Work Order, SMS, Streaming Media, and more
# Clone the repository git clone <repository-url> cd swagger-mcp-server # Install dependencies npm install # Deploy to Cloudflare Workers npm run deploy
Your MCP server will be available at:https://swagger-mcp-server.<your-account>.workers.dev/sse
# Start local development server npm run dev # Server available at: http://localhost:8787/sse
Update the authentication tokens insrc/config.ts:
{ name: "device_mgr_enterprise", title: "IoT Device Manager (Enterprise)", auth: { type: 'bearer', token: 'your-bearer-token-here' }, enabled: true, maxTools: 8 }
Control which APIs are active by modifying theenabledflag:
{ "name": "mail_enduser", "title": "Mail Service (EndUser)", "enabled": false, // Set to true to enable "maxTools": 4 }
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{ "mcpServers": { "iot-apis": { "command": "npx", "args": [ "mcp-remote", "https://swagger-mcp-server.your-account.workers.dev/sse" ] } } }
The server automatically generates tools from Swagger specifications with intelligent naming:
- device_mgr_enterprise_getDevices- List all devices
- binding_enduser_bindDevice- Bind device to user
- deviceshadow_enterprise_updateShadow- Update device shadow
- weather_enduser_getCurrentWeather- Get current weather data
- And ~96 more tools across all enabled APIs
# Using Claude "List all available APIs and their status"
# Using Claude "Test the MCP server connection"
Claude Desktop/AI Playground ↓ MCP JSON-RPC 2.0 ↓ Cloudflare Workers ↓ McpAgent (Durable Objects) ↓ Multi-API Tool Router ↓ 32 IoT APIs (Acceleronix)
- High Priority APIs: 6-8 tools each (Device Management, Product, TSL)
- Medium Priority APIs: 4-6 tools each (Binding, Shadow, Data Storage)
- Utility APIs: 3-4 tools each (Weather, I18n, Bootstrap)
- Total: ~100 tools across 18 enabled APIs
- Bearer token authentication for all API calls
- Environment variable support for sensitive tokens
- CORS-enabled for browser clients
- Request validation and error handling
- MCP SSE:/sse- Server-Sent Events endpoint for Claude
- Health Check:/health- Service status and version info
- MCP JSON-RPC:/mcp- Direct JSON-RPC 2.0 endpoint
Each API provides comprehensive Swagger documentation accessible through the tools. Use thelist_apistool to see all available APIs and their descriptions.
- Fork the repository
- Add new APIs tosrc/config.ts
- Test locally withnpm run dev
- Deploy and test with Claude Desktop
- Submit a pull request
MIT License - see LICENSE file for details
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
An example of a remote MCP server deployed on Cloudflare Workers without authentication.
A remote MCP server without authentication, designed for easy deployment on Cloudflare Workers.
An example of a remote MCP server without authentication, deployable on Cloudflare Workers or runnable locally.
A remote MCP server without authentication, deployable on Cloudflare Workers or locally with npm.
A remote MCP server deployable on Cloudflare Workers that does not require authentication.
A template for deploying a remote MCP server on Cloudflare Workers without authentication.
An example of deploying a customizable, remote MCP server on Cloudflare Workers without authentication.
An example MCP server deployed on Cloudflare Workers without authentication.
A remote MCP server example deployable on Cloudflare Workers, featuring customizable tools and no authentication.
An MCP server and client implementation for EdgeOne Pages Functions, supporting OpenAI-formatted requests.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





