MCP

Documentation category for the MCP server used by Docs.

What it is

MCP (Model Context Protocol) lets AI assistants use project tools and data through a standard interface.

In this project, the MCP server is built on top of all markdown docs and API endpoint documentation.

Features

• search and read all markdown files from docs/
• API endpoint catalog generated from docs
• locale support: pl, en, nl
• API category filters: blog, faq, mcp, jobs, events, other
• improved search ranking

MCP tools

• list_docs
• get_doc
• search_docs
• list_api_endpoints
• get_api_endpoint_doc

Configuration

• workspace config: /.vscode/mcp.json
• server source: https://docs.dlapolakow.app/mcp-server/src/index.js
• server package: https://docs.dlapolakow.app/mcp-server/package.json

Deployment notes

MCP server files are published in Docs as source artifacts for reference. The MCP server itself runs as a Node.js stdio process, not as an HTTP endpoint. If you want copy-ready links, use full docs URLs.

Practical setup

1. Go to the mcp-server directory.
2. Install dependencies: npm install.
3. Start the server: npm start.
4. Connect your AI client to node .../mcp-server/src/index.js.

Requirements:

• Node.js 20+
• Access to the local docs/ files

Practical usage examples

Example prompts after MCP is connected:

• "Find the FAQ search endpoint and show its parameters"
• "List all FAQ category endpoints in English"
• "Find docs for FAQ content syntax"
• "Open docs/en/api/faq-search.md and summarize it"

Typical tool flow:

1. search_docs to find the most relevant page.
2. get_doc to read full markdown content.
3. list_api_endpoints or get_api_endpoint_doc for endpoint-focused tasks.

Integration with popular AI clients

VS Code (Copilot / Agent Mode)

This repository includes a ready-to-use /.vscode/mcp.json.

1. Open this workspace in VS Code.
2. Verify server config uses command: node and args: ["${workspaceFolder}/mcp-server/src/index.js"].
3. Reload VS Code and open the agent chat.

Claude Desktop

Add this to claude_desktop_config.json:

{
	"mcpServers": {
		"dlapolakow-docs": {
			"command": "node",
			"args": [
				"<PATH_TO_MCP_SERVER>/src/index.js"
			],
			"cwd": "<PATH_TO_MCP_SERVER>"
		}
	}
}

Replace <PATH_TO_MCP_SERVER> with the full path to your mcp-server directory.

Other MCP clients (Cursor, Cline, Roo Code, OpenCode)

Use equivalent stdio configuration:

• command: node
• args: full path to mcp-server/src/index.js
• cwd: mcp-server directory

Restart your AI client after updating config.