MCP

Kategoria dokumentacji serwera MCP dla Docs.

Co to jest

MCP (Model Context Protocol) pozwala asystentom AI korzystac z narzedzi i danych projektowych przez standardowy interfejs.

W tym projekcie serwer MCP oparty jest o cala dokumentacje markdown oraz endpointy API.

Funkcje

• wyszukiwanie i odczyt wszystkich plikow markdown z docs/
• katalog endpointow API z dokumentacji
• obsluga jezykow: pl, en, nl
• filtry kategorii API: blog, faq, mcp, jobs, events, other
• ulepszony ranking wyszukiwania

Narzedzia MCP

• list_docs
• get_doc
• search_docs
• list_api_endpoints
• get_api_endpoint_doc

Konfiguracja

• konfiguracja workspace: /.vscode/mcp.json
• kod serwera: https://docs.dlapolakow.app/mcp-server/src/index.js
• pakiet serwera: https://docs.dlapolakow.app/mcp-server/package.json

Uwagi wdrozeniowe

Pliki serwera MCP sa publikowane w Docs jako zrodla do podgladu. Sam serwer MCP uruchamia sie jako proces Node.js (stdio), a nie jako endpoint HTTP. Jezeli chcesz szybko otworzyc surowe pliki w przegladarce, uzyj pelnych URL z domena docs.

Jak uruchomic w praktyce

1. Przejdz do katalogu mcp-server.
2. Zainstaluj zaleznosci: npm install.
3. Uruchom serwer: npm start.
4. Podlacz klienta AI do komendy node .../mcp-server/src/index.js.

Wymagania:

• Node.js 20+
• Dostep do plikow dokumentacji docs/

Jak uzywac w praktyce

Przykladowe zadania dla AI po podpieciu MCP:

• „Znajdz endpoint do wyszukiwania FAQ i pokaz parametry”
• „Wypisz wszystkie endpointy kategorii FAQ po polsku”
• „Znajdz dokumentacje skladni wpisow FAQ”
• „Pokaz plik docs/en/api/faq-search.md i podsumuj zmiany”

Typowy przeplyw narzedzi:

1. search_docs aby znalesc najlepsze strony.
2. get_doc aby pobrac pelna tresc.
3. list_api_endpoints lub get_api_endpoint_doc aby pracowac stricte na endpointach.

Podpiecie pod popularne AI

VS Code (Copilot / Agent Mode)

W repo jest gotowy plik /.vscode/mcp.json.

1. Otworz ten workspace w VS Code.
2. Upewnij sie, ze serwer jest skonfigurowany przez command: node i args: ["${workspaceFolder}/mcp-server/src/index.js"].
3. Przeladuj okno VS Code i uruchom czat agenta.

Claude Desktop

Dodaj serwer do claude_desktop_config.json:

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

Zastap <PATH_TO_MCP_SERVER> pelna sciezka do katalogu mcp-server w Twoim projekcie.

Inne klienty MCP (Cursor, Cline, Roo Code, OpenCode)

Uzyj analogicznej konfiguracji stdio:

• command: node
• args: pelna sciezka do mcp-server/src/index.js
• cwd: katalog mcp-server

Po zapisaniu konfiguracji zrestartuj klienta AI.