Nextcloud Developer Documentation

This project provides a Dockerized MCP server that fetches and indexes one or more documentation source URLs recursively, then exposes MCP tools for coding agents. The first configured sources are:

• https://github.com/nextcloud-deps/ocp (full repo, recursive)
• https://github.com/nextcloud/documentation/tree/master/developer_manual (subtree, recursive)
• https://github.com/nextcloud/server/blob/master/openapi.json
• https://github.com/nextcloud-libraries/nextcloud-vue (upstream source for node_modules/@nextcloud/vue)

The nextcloud-developer-documentation-mcp container runs as a persistent HTTP MCP service on http://localhost:8000/nextcloud-developer-documentation-mcp. On every container start, all configured source URLs are refreshed and the index is rebuilt before the server begins accepting MCP requests.

The intended end-user configuration is minimal:

• run docker compose up -d nextcloud-developer-documentation-mcp
• point your coding agent to http://localhost:8000/nextcloud-developer-documentation-mcp

MCP tools

• search_docs(query, top_k=5)
  • Full-text search over indexed files from all configured source URLs.
• get_doc(path, chunk=None, max_chars=12000)
  • Fetch full content (chunked) for an indexed file path.
• answer_docs(question, top_k=6)
  • Retrieval-based answer with references.
• refresh_index()
  • Pull latest state for all configured source URLs and rebuild index.
• docs_health()
  • Health/index metadata.
• list_indexed_files(limit=200, offset=0, prefix=None)
  • Lists indexed file paths for validation (supports pagination and prefix filtering).

What gets indexed

By default, these file extensions are indexed from all configured source URLs:

• .md, .php, .rst, .txt, .yml, .yaml, .json, .js, .ts, .vue, .css, .scss

The index is a SQLite FTS5 database persisted in a Docker volume (nextcloud-docs-data).

Run with Docker Compose

Start the persistent HTTP MCP server:

docker compose up -d nextcloud-developer-documentation-mcp

Add to coding agents (like Claude Code)

Point the agent at the running HTTP MCP endpoint:

{
  "mcpServers": {
    "nextcloud-developer-documentation": {
      "url": "http://localhost:8000/nextcloud-developer-documentation-mcp"
    }
  }
}

Add to coding agent Codex App

[mcp_servers.nextcloud_developer_documentation]
url = "http://localhost:8000/nextcloud-developer-documentation-mcp"
enabled = true

Agents that support HTTP MCP can use the same endpoint directly.