clive-doc-mcp

Local Node.js MCP server for ShowDoc, with browser-based authorization and document read/write tools.

Features

• Browser authorization flow (showdoc_authorize_browser)
• List projects (showdoc_list_projects)
• List docs in a project (showdoc_list_project_docs)
• Parse ShowDoc article links (showdoc_parse_article_link)
• Read docs (showdoc_read_doc)
• Create or update docs (showdoc_write_doc)

MCP Client Config Example

Use npx directly:

{
  "mcpServers": {
    "clive-doc-mcp": {
      "command": "npx",
      "args": ["-y", "clive-doc-mcp", "--url=https://doc.cliveli.tech/"]
    }
  }
}

Alternative (set base URL with env):

{
  "mcpServers": {
    "clive-doc-mcp": {
      "command": "npx",
      "args": ["-y", "clive-doc-mcp"],
      "env": {
        "SHOWDOC_BASE_URL": "https://doc.cliveli.tech/"
      }
    }
  }
}

Authorization

1. Call showdoc_authorize_browser.
2. Open authorize_url (or let the tool auto-open browser).
3. In that browser, ensure ShowDoc is already logged in.
4. The page /web/mcp/authorize will use current login session to generate one-time code and redirect to local callback.
5. After success, use showdoc_auth_status or directly call list/read/write tools.

No MCP-side password input is required.

Auth data is saved to:

• ${SHOWDOC_MCP_AUTH_FILE} when set
• otherwise ~/.showdoc-mcp-auth.json

Optional Environment Variables

• SHOWDOC_BASE_URL: default ShowDoc base URL
• SHOWDOC_USER_TOKEN: bypass browser auth and use fixed token
• SHOWDOC_USERNAME: optional display value when using SHOWDOC_USER_TOKEN
• SHOWDOC_MCP_AUTH_FILE: override auth session file path

Optional CLI Parameters

• --url=https://doc.cliveli.tech/: default ShowDoc base URL
• --base-url=https://doc.cliveli.tech/: same as --url

Notes

• showdoc_write_doc needs item_id (or item_domain) for creates.
• For updates, if only page_id is provided, the tool auto-loads existing page info.
• Link parser supports routes like:
  • http://host/web/#/123/456
  • http://host/web/123/456
  • http://host/123/456
  • http://host/page/456/123