mcp-adr-analysis-server 2.7.24 → 2.7.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -32
- package/dist/.tsbuildinfo +1 -1
- package/dist/src/index.d.ts +0 -4
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +0 -57
- package/dist/src/index.js.map +1 -1
- package/dist/src/tools/bootstrap-validation-loop-tool.d.ts +0 -178
- package/dist/src/tools/bootstrap-validation-loop-tool.d.ts.map +1 -1
- package/dist/src/tools/bootstrap-validation-loop-tool.js +0 -1580
- package/dist/src/tools/bootstrap-validation-loop-tool.js.map +1 -1
- package/dist/src/tools/tool-catalog.d.ts.map +1 -1
- package/dist/src/tools/tool-catalog.js +2 -22
- package/dist/src/tools/tool-catalog.js.map +1 -1
- package/dist/src/utils/ai-executor.d.ts +1 -1
- package/dist/src/utils/ai-executor.js +1 -1
- package/dist/src/utils/config.d.ts +0 -3
- package/dist/src/utils/config.d.ts.map +1 -1
- package/dist/src/utils/config.js +0 -13
- package/dist/src/utils/config.js.map +1 -1
- package/dist/src/utils/research-orchestrator.d.ts +0 -28
- package/dist/src/utils/research-orchestrator.d.ts.map +1 -1
- package/dist/src/utils/research-orchestrator.js +15 -252
- package/dist/src/utils/research-orchestrator.js.map +1 -1
- package/dist/src/utils/server-context-generator.d.ts.map +1 -1
- package/dist/src/utils/server-context-generator.js +0 -1
- package/dist/src/utils/server-context-generator.js.map +1 -1
- package/package.json +1 -3
- package/dist/src/tools/llm-web-search-tool.d.ts +0 -59
- package/dist/src/tools/llm-web-search-tool.d.ts.map +0 -1
- package/dist/src/tools/llm-web-search-tool.js +0 -165
- package/dist/src/tools/llm-web-search-tool.js.map +0 -1
- package/dist/src/utils/dag-executor.d.ts +0 -106
- package/dist/src/utils/dag-executor.d.ts.map +0 -1
- package/dist/src/utils/dag-executor.js +0 -453
- package/dist/src/utils/dag-executor.js.map +0 -1
- package/dist/src/utils/deployment-task-integration.d.ts +0 -260
- package/dist/src/utils/deployment-task-integration.d.ts.map +0 -1
- package/dist/src/utils/deployment-task-integration.js +0 -393
- package/dist/src/utils/deployment-task-integration.js.map +0 -1
- package/dist/src/utils/dynamic-deployment-intelligence.d.ts +0 -117
- package/dist/src/utils/dynamic-deployment-intelligence.d.ts.map +0 -1
- package/dist/src/utils/dynamic-deployment-intelligence.js +0 -445
- package/dist/src/utils/dynamic-deployment-intelligence.js.map +0 -1
- package/dist/src/utils/pattern-contribution-helper.d.ts +0 -60
- package/dist/src/utils/pattern-contribution-helper.d.ts.map +0 -1
- package/dist/src/utils/pattern-contribution-helper.js +0 -308
- package/dist/src/utils/pattern-contribution-helper.js.map +0 -1
- package/dist/src/utils/pattern-loader.d.ts +0 -183
- package/dist/src/utils/pattern-loader.d.ts.map +0 -1
- package/dist/src/utils/pattern-loader.js +0 -198
- package/dist/src/utils/pattern-loader.js.map +0 -1
- package/dist/src/utils/pattern-to-dag-converter.d.ts +0 -62
- package/dist/src/utils/pattern-to-dag-converter.d.ts.map +0 -1
- package/dist/src/utils/pattern-to-dag-converter.js +0 -265
- package/dist/src/utils/pattern-to-dag-converter.js.map +0 -1
- package/dist/src/utils/resource-extractor.d.ts +0 -57
- package/dist/src/utils/resource-extractor.d.ts.map +0 -1
- package/dist/src/utils/resource-extractor.js +0 -323
- package/dist/src/utils/resource-extractor.js.map +0 -1
- package/dist/src/utils/system-card-manager.d.ts +0 -194
- package/dist/src/utils/system-card-manager.d.ts.map +0 -1
- package/dist/src/utils/system-card-manager.js +0 -336
- package/dist/src/utils/system-card-manager.js.map +0 -1
package/README.md
CHANGED
|
@@ -32,7 +32,6 @@ The **Model Context Protocol (MCP)** is an open standard that enables seamless i
|
|
|
32
32
|
| **Tree-sitter** | An incremental parsing library that provides AST (Abstract Syntax Tree) analysis for 50+ languages. Used for semantic code understanding, extracting function signatures, and identifying architectural patterns. |
|
|
33
33
|
| **Knowledge Graph** | A graph database maintained by the server that tracks relationships between ADRs, code implementations, and architectural decisions. Enables intelligent code linking and impact analysis. |
|
|
34
34
|
| **Smart Code Linking** | AI-powered discovery of code files related to ADRs and architectural decisions, using keyword extraction and semantic search. |
|
|
35
|
-
| **Firecrawl** | Web page extraction/search service used by optional research tools (`FIRECRAWL_API_KEY`). |
|
|
36
35
|
| **ADR Aggregator** | Optional SaaS integration for syncing and sharing ADR context across teams (`ADR_AGGREGATOR_API_KEY`). |
|
|
37
36
|
|
|
38
37
|
</details>
|
|
@@ -232,7 +231,7 @@ const relatedCode = await findRelatedCode(
|
|
|
232
231
|
## 🛠️ Technology Stack
|
|
233
232
|
|
|
234
233
|
**Runtime:** Node.js 20+ • **Language:** TypeScript • **Framework:** MCP SDK • **Testing:** Vitest (~49% statements, enforced floor)
|
|
235
|
-
**Search:** [ripgrep](https://github.com/BurntSushi/ripgrep) (fast recursive text search) + fast-glob (file matching) • **AI Integration:** OpenRouter.ai • **
|
|
234
|
+
**Search:** [ripgrep](https://github.com/BurntSushi/ripgrep) (fast recursive text search) + fast-glob (file matching) • **AI Integration:** OpenRouter.ai • **Code Analysis:** [tree-sitter](https://tree-sitter.github.io/tree-sitter/) (incremental code parser) + Smart Code Linking
|
|
236
235
|
|
|
237
236
|
📖 **[Technical Details →](docs/explanation/server-architecture.md)** | **[CE-MCP Migration Playbook →](docs/how-to-guides/ce-mcp-migration-playbook.md)**
|
|
238
237
|
|
|
@@ -256,36 +255,6 @@ npm run test:coverage # Coverage report
|
|
|
256
255
|
|
|
257
256
|
📖 **[Testing Guide →](docs/how-to-guides/troubleshooting.md)**
|
|
258
257
|
|
|
259
|
-
## 🔥 Firecrawl Integration (Optional — Skip for Getting Started)
|
|
260
|
-
|
|
261
|
-
**Enhanced web research capabilities for comprehensive architectural analysis.**
|
|
262
|
-
|
|
263
|
-
> **Note:** You don't need Firecrawl for basic ADR analysis. The server works fully without it. Only configure Firecrawl if you need web research features like the `perform_research` tool with external sources.
|
|
264
|
-
|
|
265
|
-
<details>
|
|
266
|
-
<summary><b>When is Firecrawl useful?</b></summary>
|
|
267
|
-
|
|
268
|
-
- **ADR research** — automatically pull best practices from official docs when generating ADRs
|
|
269
|
-
- **Technology evaluation** — compare frameworks by crawling their documentation and changelogs
|
|
270
|
-
- **Security audits** — check CVE databases and security advisories for your dependencies
|
|
271
|
-
- **Migration planning** — gather migration guides and breaking-change notes from upstream projects
|
|
272
|
-
|
|
273
|
-
</details>
|
|
274
|
-
|
|
275
|
-
```bash
|
|
276
|
-
# Option 1: Cloud service (recommended)
|
|
277
|
-
export FIRECRAWL_ENABLED="true"
|
|
278
|
-
export FIRECRAWL_API_KEY="fc-your-api-key-here"
|
|
279
|
-
|
|
280
|
-
# Option 2: Self-hosted
|
|
281
|
-
export FIRECRAWL_ENABLED="true"
|
|
282
|
-
export FIRECRAWL_BASE_URL="http://localhost:3000"
|
|
283
|
-
|
|
284
|
-
# Option 3: Disabled (default - server works without web search)
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
📖 **[Firecrawl Setup Guide →](docs/reference/environment-config.md#firecrawl-configuration)**
|
|
288
|
-
|
|
289
258
|
## 🌐 ADR Aggregator Integration (Optional)
|
|
290
259
|
|
|
291
260
|
[ADR Aggregator](https://adraggregator.com) is a platform for cross-team ADR visibility and governance. It provides:
|