docsbook-mcp

A thin open-source proxy to the hosted Docsbook MCP server.

Docsbook is an AI-native documentation platform — hosting, AI chat over your docs, analytics, SEO/GEO/AEO optimization, translations, and webhooks, all driven from a GitHub repo. This package is a small stdio MCP server that forwards requests to Docsbook's hosted MCP endpoint, giving any MCP client (Claude Desktop, Claude Code, Cursor, etc.) access to ~40 tools for managing a Docsbook workspace: branding, navigation, SEO/GEO/AEO, the AI chat system prompt, translations, analytics, webhooks, and the doc source-of-truth graph.

The actual tool implementations live in Docsbook's hosted backend (https://docsbook.io/api/mcp/server) — this repo contains no proprietary code, no database access, and no secrets. It is ~150 lines that speak stdio to your MCP client on one side and Streamable HTTP to the hosted endpoint on the other.

Install & configure

Claude Code

claude mcp add docsbook -- npx -y docsbook-mcp

Then set your token as an environment variable, or pass it via claude mcp add --env:

claude mcp add docsbook --env DOCSBOOK_MCP_TOKEN=your-token-here -- npx -y docsbook-mcp

Claude Desktop (or any JSON-config MCP client)

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "docsbook": {
      "command": "npx",
      "args": ["-y", "docsbook-mcp"],
      "env": {
        "DOCSBOOK_MCP_TOKEN": "..."
      }
    }
  }
}

Get a token from your workspace's MCP settings at https://docsbook.io/settings/mcp.

Related MCP server: mcp-developer-portal

Environment variables

How it works

• On tools/list, this proxy forwards to the hosted endpoint (with your DOCSBOOK_MCP_TOKEN as a Bearer token, if set) and returns whatever tools the server currently exposes — the tool list is never hardcoded here.

• If the upstream is unreachable, or no token is configured, it falls back to a bundled static tool manifest (src/tools-manifest.json) so the server can still respond to initialize/tools/list (useful for sandboxed registry introspection, e.g. Glama). This fallback list may lag behind the live tool set — see the _comment field in that file for how it was assembled.

• On tools/call, it forwards the call to the hosted endpoint. If no token is configured, it returns a clear MCP error pointing you to https://docsbook.io/settings/mcp.

Development

npm install
npm run build
node dist/index.js

Learn more

• Docsbook

• Model Context Protocol

License

MIT