DevHub

Implements a FastMCP server that translates natural language requests from LLM clients into authenticated OAuth1 API calls to the DevHub CMS backend, using requests-oauthlib for credential injection and structured response formatting. The server acts as a translation layer that handles authentication state management, request serialization, and response deserialization without requiring LLMs to implement native DevHub API integration.

Exposes DevHub CMS operations as standardized MCP tools that work across Claude Desktop, Cursor IDE, Claude Code CLI, and Smithery package manager through a single FastMCP server implementation. Tools are declaratively defined with schema validation, parameter documentation, and structured output formatting, enabling LLM clients to discover and invoke capabilities without custom integration code.

Provides tools to query DevHub CMS business and location data with hierarchical relationships, including get_businesses (retrieve all businesses), get_locations (retrieve locations for a specific business), get_nearest_location (find closest location by coordinates), and site_from_url (resolve business from website URL). Implements geospatial distance calculation and URL-to-business reverse lookup, enabling LLMs to navigate multi-location business structures.

Exposes get_hours_of_operation (retrieve current hours for a business/location) and update_hours (modify hours with validation and persistence to DevHub CMS). Updates are immediately persisted to the DevHub backend via authenticated API calls, enabling LLMs to manage business hours directly without manual CMS access. Supports structured hours data with day-of-week granularity.

Implements get_blog_post (retrieve published blog content by slug), create_blog_post (publish new blog posts with title, body, metadata), and update_blog_post (modify existing posts) with full persistence to DevHub CMS. Each operation maps to authenticated DevHub API endpoints, enabling LLMs to manage blog content lifecycle without CMS UI access. Supports structured metadata (tags, categories, publish status).

Exposes upload_image tool that accepts image files (binary or base64-encoded) and persists them to DevHub CMS media storage with metadata (alt text, title, description). Handles multipart form encoding for file transmission and returns media asset URLs/IDs for reference in blog posts and other content. Integrates with DevHub's asset management backend.

Supports four distinct installation methods (Claude Desktop via uvx, Cursor IDE via MCP config, Claude Code CLI via claude mcp add, Smithery via npx) that deploy the same FastMCP server code to different environments. Each method handles platform-specific configuration (config file paths, environment variable injection, package registry integration) while maintaining identical server behavior. Enables developers to choose deployment method based on their LLM client preference.

Manages DevHub CMS OAuth1 credentials (API key, API secret, base URL) through environment variables (DEVHUB_API_KEY, DEVHUB_API_SECRET, DEVHUB_BASE_URL) that are read at server startup and injected into all API requests via requests-oauthlib. Credentials are never exposed to LLM clients or stored in configuration files, enabling secure multi-client access without credential sharing. Supports both local development and containerized deployment.

Defines MCP tools with explicit JSON schemas that specify parameter types, required fields, descriptions, and constraints. FastMCP framework validates incoming tool calls against these schemas before execution, rejecting malformed requests with validation errors. Enables LLM clients to discover tool capabilities through schema introspection and provides type safety for API calls.

Implements consistent error handling across all MCP tools with structured error responses that include HTTP status codes, error messages, and diagnostic information. All successful tool calls return JSON-formatted responses that LLM clients can easily parse and present to users. Errors from DevHub API are caught, formatted, and returned to LLM clients without exposing raw API responses.