borghei/Claude-Skills / engineering/mcp-server-builder
mcp-server-builder
VerifiedBuilds MCP servers: OpenAPI-to-tool conversion, tool and schema linting, TypeScript or Python scaffolds, transports. Use when exposing an API to AI agents, building a tool server, or reviewing MCP tool definitions.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.5 KB |
| assets/flawed_tools.json | config | 410 B |
| assets/sample_openapi.json | config | 1.8 KB |
| references/server-implementation.md | markdown | 9.7 KB |
| references/streaming-batch-and-computer-use.md | markdown | 11.0 KB |
| references/testing-and-troubleshooting.md | markdown | 5.8 KB |
| references/tool-schema-design.md | markdown | 2.4 KB |
| references/transport-and-deployment.md | markdown | 1.8 KB |
| scripts/openapi_converter.pyexecutable | script | 14.3 KB |
| scripts/server_scaffolder.pyexecutable | script | 11.4 KB |
| scripts/tool_linter.pyexecutable | script | 13.1 KB |
| scripts/tool_schema_linter.py | script | 11.1 KB |
references/transport-and-deployment.md
View on GitHub# Transport and Deployment
Read this when choosing a transport, wiring a server into a client, and managing tool versions across releases.
## Choosing a Transport
| Transport | Use for | Notes |
|-----------|---------|-------|
| stdio | Local tools launched by the client (CLI, desktop) | Simplest; no network, no auth; one client per process |
| Streamable HTTP | Remote and shared servers | The current spec's HTTP transport: one endpoint (conventionally `/mcp`) for POST requests, with optional streamed responses; put auth in front of it |
| HTTP+SSE | Legacy clients only | Replaced by Streamable HTTP in the 2025 spec revisions; keep only for backward compatibility |
Default to stdio for local tools and Streamable HTTP for anything remote. Check the SDK version you install for the exact transport class names.
## Client Configuration
### Claude Code (project `.mcp.json`)
```json
{
"mcpServers": {
"project-tools": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"PROJECT_ROOT": "/path/to/project",
"DATABASE_URL": "${DATABASE_URL}"
}
},
"remote-api-tools": {
"type": "http",
"url": "https://mcp.mycompany.com/mcp",
"headers": {
"Authorization": "Bearer ${MCP_API_TOKEN}"
}
}
}
}
```
Claude Desktop reads the same `mcpServers` shape from `claude_desktop_config.json`. Keep secrets in environment variables, never inline.
## Versioning Strategy
- **Additive changes** (new tools, new optional parameters): non-breaking, bump minor version
- **Tool removal or rename**: breaking, requires deprecation period + major version bump
- **Required parameter addition**: breaking, consider making it optional with a default instead
- **Response format changes**: potentially breaking, document in changelog
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |