drupal-dev MCP server
2026년 11월 9일 커밋로컬 SQLite 인덱스와 검증 가능한 인용을 사용하여 AI 에이전트에게 버전별 Drupal 문서 및 API 지식을 제공합니다.
다른 이름 ednark/drupal-dev-mcp
- 스타
- 0
- Tools
- 18
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
drupal-dev MCP란?
로컬 SQLite 인덱스와 검증 가능한 인용을 사용하여 AI 에이전트에게 버전별 Drupal 문서 및 API 지식을 제공합니다. 18개 도구를 제공합니다. 예: question, drupal_version, query.
프로젝트 README에서 생성된 요약
drupal-dev MCP server 정보
이 MCP server의 주요 기능은 AI 코딩 에이전트에게 버전별 Drupal 문서와 API 가이드를 제공하는 것입니다. 핵심 API 문서, 변경 기록, Symfony 또는 PHP 문서를 포함하는 로컬 SQLite 인덱스를 사용하여 개발자가 정확한 정보를 받을 수 있도록 합니다. 이 서버는 읽기 전용으로 설계되었으며, drupal:// URI를 통해 검증 가능한 인용을 제공하는 6개의 결정론적 검색 도구를 제공합니다.
사용자는 Drupal 10.6, 11.4 또는 12.0.x 프리릴리스와 같은 특정 버전을 쿼리할 수 있습니다. 시스템은 stdio 전송 방식을 통해 로컬에서 실행되며 Docker가 필요하지 않습니다. 대부분의 도구는 순수 증거 검색용이지만, ask_a_drupal_expert라는 선택형 합성 도구를 통해 근거 있는 의사결정이 가능합니다. 이 특정 도구는 OpenAI API 키가 필요하며, 단일 라운드 질문 모드 또는 멀티 라운드 조사 모드로 작동할 수 있습니다. 서버는 LanceDB 임베딩을 통한 선택적 시맨틱 검색을 지원하지만, 임베딩이 구성되지 않은 경우 SQLite FTS5를 사용하는 어휘 기반 전용 모드로도 작동합니다.
활용 사례
- 1Drupal API 문서 검증AI 에이전트가 문서의 정확한 인덱싱 텍스트를 검색하여 주장의 정확성을 확인할 수 있습니다.
- 2모듈 이름 유효성 검사개발자가 composer를 통해 모듈을 설치하기 전에 모듈 이름이 올바른지 확인하는 데 사용할 수 있습니다.
- 3버전별 조사 수행에이전트가 반복적인 조사를 수행하여 특정 버전 간의 서로 다른 Drupal 개념을 비교할 수 있습니다.
- 4API 관계 탐색개발자가 Drupal 그래프 내에서 서로 다른 엔티티 또는 증거가 어떻게 연결되어 있는지 탐색하는 데 사용할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
drupal-dev MCP 도구 18
README에서 감지됨questiondrupal_versionquerydatasetstop_kper_dataset_limitstrategyinclude_textinclude_metadatamax_iterationsqueries_per_iterationinitial_top_k
| question | — | |
| drupal_version | — | |
| query | — | |
| datasets | — | |
| top_k | — | |
| per_dataset_limit | — | |
| strategy | — | |
| include_text | — | |
| include_metadata | — | |
| max_iterations | — | |
| queries_per_iteration | — | |
| initial_top_k | — |
도구 18개 모두 보기도구 수 줄이기
followup_top_kmax_evidence_chunksoutput_formatinclude_evidence_textskill_idformat
| followup_top_k | — | |
| max_evidence_chunks | — | |
| output_format | — | |
| include_evidence_text | — | |
| skill_id | — | |
| format | — |
구성
DRUPAL_MCP_INDEX_ROOTLANCEDB_PATHOPENAI_AGENT_MODELOPENAI_API_KEYOPENAI_BASE_URL
| 이름 | 설명 | 유형 |
|---|---|---|
| DRUPAL_MCP_INDEX_ROOT | — | |
| LANCEDB_PATH | — | |
| OPENAI_AGENT_MODEL | — | |
| OPENAI_API_KEY | — | |
| OPENAI_BASE_URL | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능ednark/drupal-dev-mcp is public and reachablegithub.com/ednark/drupal-dev-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-09github.com/ednark/drupal-dev-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음18 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기drupal-dev-mcp
Version-aware Drupal knowledge for AI coding agents — with citations you can verify.
An MCP server that answers Drupal questions from a local, version-scoped index of core API docs, change records, contrib source, Symfony/PHP docs, and curated guidance. Every result carries a drupal:// citation, and get_drupal_document returns the exact indexed text behind a claim so it can be checked rather than trusted.
- Read-only by design. The six retrieval tools never synthesize advice. The single synthesis tool (
ask_a_drupal_expert) is opt-in, needs its own API key, and returnsinsufficient_evidenceinstead of guessing. - Version-aware. Query Drupal 10.6, 11.4, or the 12.0.x pre-release — or ask for an explicit cross-version search.
- Runs locally. SQLite FTS5 plus a semantic graph. Embeddings are optional; without them search still works and reports
degraded_mode: "lexical_only". - No server, no Docker. One local index, stdio transport, MIT licensed.
Version 0.2 is a clean-break redesign with three npm workspaces (none published to npm):
@drupal-dev-mcp/knowledgebuilds and queries a versioned SQLite, FTS5, semantic-graph, and optional LanceDB index.@drupal-dev-mcp/serverexposes seven deterministic MCP tools (six retrieval tools plus one opt-in synthesis tool) and three resource surfaces over aKnowledgeProvider.@drupal-dev-mcp/agentcontains optional OpenAI-backed answer and iterative-research workflows as a library, CLI, and the engine behind the server'sask_a_drupal_experttool.
The retrieval tools do not synthesize advice; ask_a_drupal_expert is the single explicit exception, gated on its own API key. The server never runs indexing, executes commands, fetches arbitrary URLs, or mutates the workspace.
Quick start
Requirements: Node.js 22+ (26 recommended — .nvmrc pins it), npm 10+, Git, and enough local disk for two Drupal core checkouts and the generated index. better-sqlite3 is a native module: after a Node major upgrade, run npm rebuild better-sqlite3 if it fails to load (the test suite's pretest doctor check will tell you).
npm install
npm run build
npm run index:fetch
npm run index:rebuild
npm run index:verify
npm run mcp:start
The active build defaults to Drupal 11.4. Every query can target Drupal 10.6, the pre-release Drupal 12.0 (12.0.x branch), or request an explicit cross-version search.
Embeddings are optional. Without them, search remains fully operational through SQLite FTS5 and returns degraded_mode: "lexical_only". To create the unified LanceDB table, explicitly authorize sending indexed chunk text to the configured embedding provider and run:
npm run index:rebuild -- --with-embeddings
MCP surface
The normative wire contract for these tools — schemas, result envelope, _meta keys, resource URIs, capability advertisement, and status semantics — is docs/tools-spec.md. A companion agent skill packages the usage guidance (routing, grounding workflow, token budgeting) for skill-aware clients: skills/querying-drupal-knowledge/. The six read-only, non-destructive, idempotent, closed-world retrieval tools plus one opt-in synthesis tool:
search_drupal— searches evidence using version, mode, project, source type, entity kind, limit, snippet-budget, and relevance-floor (min_score) filters. Short keyword/identifier queries score best; semantic hits carry chunk-level citation URIs. Ordering is deterministic within an index build.source_types: ["guidance"]narrows to the curated guidance corpora — change-placement docs and AI-frequent anti-pattern docs (legacy-pattern fallbacks like service-locator calls,|rawin Twig, missing cache metadata, and their current replacements);["tooling"]also matches validation-tooling guidance (PHPStan/PHPCS/complexity tooling and the agent fix-loop pattern).get_drupal_entity— resolves an opaqueent_…ID or exact identifier and returns disambiguation, metadata, deprecations, evidence, and relationships.get_drupal_entities— resolves up to 25 opaqueent_…IDs in one call; unknown IDs are reported per item instead of failing the batch.explore_drupal_relationships— traverses evidence-backed graph edges with predicate, direction, depth, confidence, and node limits.get_drupal_document— returns the exact indexed text of a document or a single chunk, for verifying citations against source without re-searching.get_index_status— reports the active verified build: readiness, build date, versions, counts, verification, and build-drift detection (staleBuildwhen the index was rebuilt after this server spawned).verify_drupal_modules— deterministic module-name verification against the indexed registry: per machine name,core/contrib/not_foundwith evidence. Catches fabricated or misspelled module names beforecomposer installordrush en.ask_a_drupal_expert(opt-in synthesis) — evidence-grounded answers to questions that need conclusions rather than retrieval ("where do style changes live?", "when is a custom theme warranted?", "how should I migrate this site?"). Runs in two modes:depth: "ask"(one evidence round) anddepth: "research"(iterative multi-query rounds). Every claim is cited withdrupal://URIs; questions it cannot ground returninsufficient_evidenceinstead of guesses. RequiresOPENAI_API_KEYin the MCP client's env for this server — without it the tool returnsstatus: "unavailable"and all other tools keep working. This tool exists as the worked example of turning indexed sources into grounded decisions; the six retrieval tools remain pure-evidence.
Every successful result includes a stable resource URI, version compatibility, provenance, authority, and freshness. Graph traversal defaults to confidence >= 0.7.
Resources:
drupal://index/status
drupal://entity/{id}
drupal://document/{id}
drupal://document/{id}#chunk/{chunkId}
Running your own agent loop around this server? See docs/integration-agent-loops.md for the canonical client config, annotation-based policy mapping, recommended call patterns, and token-budgeting knobs.
Example MCP client entry after npm run build:
{
"mcpServers": {
"drupal-dev-mcp": {
"command": "node",
"args": ["/absolute/path/to/drupal-dev-mcp/packages/server/dist/index.js"],
"env": {
"DRUPAL_MCP_INDEX_ROOT": "/absolute/path/to/drupal-dev-mcp/data/index"
}
}
}
}
Maintainer commands
npm run index:fetch # refresh all git-based sources (core snapshots, contrib code, examples, skills, symfony docs); -- --core-only for core snapshots alone
npm run index:fetch-advisories # fetch Drupal core security advisories (cron-friendly; --pages=N for backfill, --check-only to diff)
npm run index:fetch-change-records # fetch NEW change records + full text (cron-friendly; --backfill-full-text upgrades existing files)
npm run index:build # build and atomically activate a verified index
npm run index:verify # verify active SQLite integrity and references
npm run index:rebuild # clean full-index build; no old-index migration
npm run index:status # report active run, counts, versions, and warnings
npm run index:freshness # compare data/sources against the active build; exit 1 when sources need re-processing
# add --check-upstream to also git-fetch each source's remote and flag clones whose
# upstream moved (status: upstream_drift) — disk-vs-index "fresh" does NOT mean upstream-current
npm run index:benchmark # rank-aware retrieval gate (39 cases: top-3 pass, MRR, chrome invariant, negative terms); -- --save-baseline refreshes docs/eval/benchmark-baseline.json; regression-fails against the stored baseline otherwise
npm run index:health # corpus ingestion-quality gate: chrome ratio, stub ratio, size floors per text source (catches pollution search gates cannot see)
npm run index:version-smoke # version-scoped retrieval probes (per-version presence/absence matrix); exit 1 on failure
npm run check # typecheck + test in one gate
npm test
Builds live under data/index/builds/{run-id}. A build becomes active only after verification passes and data/index/active.json is atomically replaced. A failed build leaves the prior active manifest untouched.
Optional agent
The agent package receives evidence only through KnowledgeProvider and explicitly reports insufficient evidence. Synthesis prompts enforce strict grounding (evidence-only claims, chunk-level drupal:// citations, source-authority weighting, version and deprecation awareness); the research loop tracks already-executed queries and generates short keyword-style follow-ups. Tool calls, admitted evidence, iterations, budgets, and stop reasons are observable.
npm run agent:ask -- --drupal-version 11.4 "How does dependency injection work?"
npm run agent:research -- --drupal-version 11.4 --max-iterations 4 "Compare event subscribers and hooks"
Set OPENAI_API_KEY and optionally OPENAI_AGENT_MODEL in .env. Agent citations retain both stable drupal:// resource URIs and canonical source URLs.
LLM providers and model sizing
The agent (and therefore ask_a_drupal_expert) speaks the OpenAI Chat Completions API, so it also works against any OpenAI-compatible local endpoint:
# .env — Ollama example
OPENAI_BASE_URL=http://localhost:11434/v1
OPENAI_API_KEY=ollama # placeholder; the endpoint ignores it
OPENAI_AGENT_MODEL=qwen3:32b # any locally pulled model tag
The same two variables belong in your MCP client config (env block for this server) when using the expert tool, not just .env. Without a custom OPENAI_BASE_URL, a real OpenAI key is required.
Hard budgets in code
These are fixed by the implementation (packages/agent/src/openai-provider.ts, packages/agent/src/agent.ts) and define what a model must cope with:
| Budget | Value | Where |
|---|---|---|
| Output cap per synthesis call | 2,000 tokens (override with AGENT_MAX_OUTPUT_TOKENS) |
answer + research report |
| Research query-planner output | 400 tokens, strict JSON required | per planning round |
Evidence bundle, depth: "ask" |
≤ 8 hits × ≤ 800-char snippets ≈ 2–4k input tokens total prompt | one search round |
Evidence bundle, depth: "research" |
up to 24 admitted items ≈ 8–12k input tokens final report prompt (budget adjustable 5–100) | accumulated rounds |
What that means for local models
- Context window: 8k is enough to run
ask; aim for ≥16k–32k forresearchso evidence plus a full report fit without truncation. RaiseAGENT_MAX_OUTPUT_TOKENSonly if your hardware gives the model headroom for it. - Capability floor: every synthesis call must emit grounded, URI-cited prose, and research mode additionally requires reliable strict-JSON emission from the planner. That instruction-following burden is why sub-7B models tend to produce mushy or uncited answers even when they "fit".
- Practical minimum: instruction-tuned ~8B class (e.g.
llama3.1:8b-instruct-q4_K_M) — acceptable forask. - Recommended: 30B+ class (e.g.
qwen3:32b) forresearchreports worth keeping.
- Practical minimum: instruction-tuned ~8B class (e.g.
- Graceful degradation is built in: if a small model emits invalid planner JSON, the research loop simply stops after admitting what it found rather than crashing; an empty evidence set yields an explicit
insufficient_evidenceanswer. - Verify small-model output: weaker models still cite plausible-looking URIs that may be wrong. The mechanical check exists for exactly this — pass their
drupal://citations toget_drupal_documentand confirm exact text before trusting them (see docs/integration-agent-loops.md).
Caveat: only generation is provider-swappable today. Embeddings (hybrid semantic search and index builds with --with-embeddings) always use OpenAI embedding endpoints; fully local setups should expect lexical-only retrieval unless they have an embeddings key set.
Architecture and migration
See docs/architecture-0.2.md for schemas, extraction confidence, retrieval stages, activation, and verification details.
The 0.1 tools ask_drupal_expert, search_drupal_docs, deep_research_drupal, drupal_skill_guide, and initialize_drupal_docs were removed. Skill guides are normal searchable documents/resources; index creation is a maintainer CLI operation; synthesis and research moved to the agent package.
As of 0.2.x, an ask_a_drupal_expert tool has been restored as a thin, opt-in MCP wrapper around the agent package, together with a curated change-placement guidance corpus (data/sources/drupal-placement-guidance/) and a crawled Drupal theming guide — so the classic "when do I use X and where does Y live" questions get grounded, citable answers instead of API-facts-only retrieval.
License
MIT. See LICENSE.
The 0.1 source trees (
src/,etl/,tests/, rootdist/, and thetsconfig.typecheck/tsconfig.fetcherconfigs) were removed in the 0.2 cleanup; this section is retained purely as a migration reference and its file paths no longer exist. The 0.1 evaluation question sets live in docs/eval/.
drupal-dev-mcp (0.1)
Drupal development MCP server powered by RAG + LLM — gives AI assistants direct access to Drupal documentation, source code, best-practice skill guides, and iterative deep-research capabilities via local vector search and OpenAI synthesis.
Overview
drupal-dev-mcp is a Model Context Protocol (MCP) server that exposes four complementary tools to any MCP-compatible AI client (Claude Desktop, Cursor, RooCode, etc.). The server is powered by a locally embedded LanceDB vector database built from a broad corpus of official Drupal documentation, API references, contrib module source code, PHP and Symfony documentation, certification study guides, and community tutorials.
Answers and research outputs are grounded entirely in the local corpus — no internet search is performed at query time. All LLM synthesis is handled by OpenAI (text-embedding-3-small for retrieval, GPT-4o for synthesis by default). The server communicates over stdio transport and is registered in your AI client's MCP configuration as a standard server entry.
The ETL pipeline fetches, parses, chunks, embeds, and loads content from 14+ knowledge sources into LanceDB tables. Once indexed, the four MCP tools can be called at any time from your AI client to retrieve canonical Drupal references, synthesize expert answers, load domain-specific skill guides, or drive multi-iteration research workflows.
Available MCP Tools
The following tools are registered in src/index.ts and exposed to MCP clients.
ask_drupal_expert
File: src/tools/ask-drupal-expert.ts
Provides conversational, citation-backed explanations for human Drupal backend developers. This tool searches the local Drupal documentation corpus and source code, then synthesizes an educational answer tailored to people seeking conceptual clarity. Covers hooks, services, dependency injection, entity API, form API, routing, config management, caching, plugins, migrations, events, and Drupal/Symfony patterns.
Primary use case: Explaining concepts, answering implementation questions, and synthesizing guidance from multiple documentation sources into a single Markdown answer with [Source N] citations and a ## Sources section.
When to use: When you need a narrative, human-readable answer with citations. Not for raw retrieval hits or structured data.
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
string | ✅ | The Drupal development question to answer |
drupal_version |
string | no | Optional version filter (e.g., "11.x"). If omitted, searches all versions. |
search_drupal_docs
File: src/tools/search-drupal-docs.ts
Raw Drupal documentation search for agents. Returns unsynthesized retrieval hits with exact excerpts and metadata. Ideal for agentic workflows where the AI client needs to inspect source material directly rather than receive a synthesized answer.
Primary use case: Gathering raw evidence chunks before deciding how to act. Use in planning workflows, before calling ask_drupal_expert, or when you want to control synthesis yourself.
When to use: When you need structured retrieval results (JSON), want to filter specific datasets, or are building agentic workflows that inspect evidence before synthesis.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query |
string | ✅ | — | Natural-language search query |
drupal_version |
string | no | all | Optional version filter (e.g., "10.x", "11.x") |
datasets |
string[] | no | all | Explicit dataset allowlist (see dataset names below) |
top_k |
integer (1–25) | no | 8 | Maximum hits returned after merge and filtering |
per_dataset_limit |
integer (1–10) | no | 4 | Maximum hits fetched from each dataset before merge |
strategy |
"tiered" | "flat" |
no | "tiered" |
Whether to preserve source-quality tiers or rank globally by relevance |
include_text |
boolean | no | true |
Whether to include chunk text in the response |
include_metadata |
boolean | no | true |
Whether to include section, file path, symbol name, and related metadata |
deep_research_drupal
File: src/tools/deep-research-drupal.ts
Iterative Drupal research planner. Produces implementation roadmaps and architectural guidance grounded in local documentation evidence. Runs multiple rounds of retrieval, using GPT-4o to generate follow-up queries, accumulate a structured evidence dossier, and synthesize key findings, open questions, contradictions, and a recommended approach.
Primary use case: Multi-domain architectural investigations, implementation planning, or any question that requires synthesizing evidence across many source types before recommending an approach.
When to use: For high-stakes, multi-step research tasks (e.g., "What is the recommended pattern for building a decoupled Drupal site with JSON:API and React?"). More expensive than ask_drupal_expert but delivers structured dossiers with implementation roadmaps and evidence ledgers.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
question |
string | ✅ | — | Primary Drupal research question |
drupal_version |
string | no | all | Optional version filter (e.g., "11.x") |
datasets |
string[] | no | all | Optional dataset allowlist for all research iterations |
max_iterations |
integer (1–6) | no | 4 | Hard cap on research rounds |
queries_per_iteration |
integer (1–5) | no | 2 | Maximum follow-up queries generated per iteration |
initial_top_k |
integer (1–15) | no | 8 | Maximum hits for the initial broad retrieval step |
followup_top_k |
integer (1–10) | no | 5 | Maximum hits per follow-up query |
max_evidence_chunks |
integer (5–40) | no | 18 | Cap on evidence stored in the final dossier |
output_format |
"json" | "markdown" |
no | "json" |
Preferred response format |
include_evidence_text |
boolean | no | false |
Whether to include full chunk text excerpts in the final response |
drupal_skill_guide
File: src/tools/drupal-skill-guide.ts
Returns Drupal best-practice skill rules for a specific domain. Reads curated SKILL.md files from the local drupal-best-practices data source, which contain authoritative naming conventions, guardrails, usage patterns, and validation commands. Pair with ask_drupal_expert for searched documentation.
Primary use case: Loading domain-specific guardrails and naming conventions before generating or reviewing Drupal configuration, code, or architecture plans.
When to use: At the start of a site-building or module-development workflow to establish the correct conventions before asking broader questions or generating code.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
skill_id |
string | ✅ | — | Drupal skill domain to retrieve. Valid values: nodes, blocks, taxonomy, fields, views, forms, text-formats-editors, theming, config-parser, other-content-entities |
format |
"raw" | "trimmed" | "json" |
no | "trimmed" |
"raw" returns the complete SKILL.md. "trimmed" strips frontmatter and ## References. "json" returns a structured object with id, title, description, usage, guardrails, validation_command, and references. |
Data Sources
The RAG index is built from the following knowledge sources. Each is fetched, parsed, chunked, embedded, and loaded into a named LanceDB dataset.
| Dataset name | Source | Description |
|---|---|---|
drupal_core_docs |
api.drupal.org, drupal.org/docs/user_guide | Core API docs, user guide, PHPDoc |
api_drupal_org_docs |
api.drupal.org/api | Canonical function, hook, and service documentation |
change_records |
drupal.org/list-changes | Release-by-release behavioral notes and API changes |
core_module_code |
git.drupalcode.org (Drupal core) | Source code of Drupal core modules |
contrib_module_code |
git.drupalcode.org (contrib) | Source code for widely used contrib modules |
contrib_module_docs |
drupal.org/docs/contributed-modules | Contrib module README and handbook pages |
contrib_module_handbook |
drupal.org/docs/contributed-modules | Handbook pages fetched via Jina proxy |
drupal_module_handbook |
drupal.org/docs/develop | Official module developer handbook |
drupal_developer_guides |
drupal.org/docs/develop/developer-tools | Modern Drupal workflow developer guides |
drupal_tutorials |
drupal.org/docs | How-to tutorials and articles |
drupal_examples |
drupal.org/project/examples | Runnable example implementations |
drupal_best_practices |
drupal.org/docs/develop/best-practices | Community best-practices guide + curated skill files |
php_docs |
php.net/manual/en/ | PHP manual pages relevant to Drupal runtime |
symfony_docs |
symfony.com/doc/current/ | Symfony component docs (routing, services, events) |
certification_docs |
acquia.com/academy | Acquia certification study guide material |
Prerequisites
- Node.js ≥ 20.0.0 (pin with
.nvmrc:nvm use) - npm ≥ 10 (bundled with Node 20)
- OpenAI API key — platform.openai.com/api-keys
- git — for cloning Drupal core during source sync
Installation
# 1. Clone the repository
git clone https://github.com/your-org/drupal-dev-mcp.git
cd drupal-dev-mcp
# 2. Install Node dependencies
npm install
# 3. Configure environment
cp .env.example .env
# Edit .env and set OPENAI_API_KEY=sk-...
# 4. Build TypeScript
npm run build
drupal-dev MCP 질문
drupal-dev MCP는 어떤 도구를 제공하나요?
18개 도구를 제공합니다. 예: question, drupal_version, query, datasets, top_k.
이 서버는 조언을 생성합니까, 아니면 정보만 검색합니까?
6개의 검색 도구는 읽기 전용이며 조언을 생성하지 않습니다. API 키가 필요한 'ask_a_drupal_expert'라는 단일 선택형 합성 도구만 존재합니다.
임베딩 없이도 사용할 수 있나요?
네, 임베딩은 선택 사항입니다. 임베딩을 사용하지 않더라도 SQLite FTS5를 통해 검색이 작동하며, 어휘 기반 전용 모드로 동작한다는 메시지가 표시됩니다.
AI가 제공한 정보를 어떻게 검증할 수 있나요?
모든 결과에는 drupal:// 인용이 포함되어 있으며, get_drupal_document 도구를 사용하여 인덱싱된 정확한 텍스트를 가져와 내용을 검증할 수 있습니다.
어떤 Drupal 버전을 지원하나요?
이 서버는 Drupal 10.6, 11.4 및 Drupal 12.0.x 프리릴리스를 포함한 여러 버전을 지원합니다.