mcp-adr-analysis-server 2.14.6 → 2.14.7

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.
Files changed (2) hide show
  1. package/README.md +11 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -29,7 +29,7 @@ The **Model Context Protocol (MCP)** is an open standard that enables seamless i
29
29
  | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
30
30
  | **ADR** | **Architectural Decision Record** — A document that captures an important architectural decision along with its context, alternatives considered, and consequences. |
31
31
  | **MCP** | **Model Context Protocol** — An open standard enabling AI assistants to connect to external tools and data sources. |
32
- | **CE-MCP** | **Claude-Enriched MCP** — Execution mode where tools return orchestration directives for the host LLM instead of making their own AI calls. Default since v2.14. |
32
+ | **CE-MCP** | **Claude-Enriched MCP** — Execution mode where tools return orchestration directives for the host LLM instead of making their own AI calls. Default since v2.14. |
33
33
  | **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. |
34
34
  | **Session & Tool-Usage Tracker** | Project-local tracking of session intents, tool executions, and ADR registrations, with keyword-scored retrieval over JSON snapshots. Supports workflow continuity and tool-usage evidence — not a graph database. |
35
35
  | **Smart Code Linking** | Discovery of code files related to ADRs and architectural decisions, using keyword extraction and ripgrep search. |
@@ -125,8 +125,11 @@ That's it. The server runs in **CE-MCP mode** by default — your host LLM (Clau
125
125
  | **Claude Desktop (macOS)** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
126
126
  | **Claude Desktop (Windows)** | `%APPDATA%\Claude\claude_desktop_config.json` |
127
127
  | **Cline (VS Code)** | VS Code Settings → Cline → MCP Servers (or `.vscode/cline_mcp_settings.json`) |
128
+ | **VS Code (native MCP)** | `.vscode/mcp.json` in workspace root |
128
129
  | **Cursor** | Cursor Settings → MCP → Add Server |
129
130
 
131
+ 📖 **[VS Code Integration Guide →](docs/how-to-guides/vscode-integration.md)** — step-by-step setup for Cline, Continue, and VS Code native MCP with example configs.
132
+
130
133
  </details>
131
134
 
132
135
  <details>
@@ -178,13 +181,13 @@ Get your API key at [adraggregator.com](https://adraggregator.com)
178
181
 
179
182
  ### Execution Modes
180
183
 
181
- | | **CE-MCP (default)** | **Full Mode (legacy)** | **Prompt-Only** |
182
- | ------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------- |
183
- | **Requires API key?** | No | Yes (`OPENROUTER_API_KEY`) | No |
184
- | **Returns** | Orchestration directives for the host LLM to execute | Server-side AI analysis results | Prompts you can paste into any AI chat |
185
- | **Set via** | Default (no env var needed) | `EXECUTION_MODE=full` | `EXECUTION_MODE=prompt-only` |
186
- | **Best for** | All users — recommended | Legacy workflows with dedicated API budget | Offline exploration |
187
- | **Tools available** | All 64 tools with annotated MCP metadata | All 64 tools | Analysis prompts, templates, local file operations, ADR discovery |
184
+ | | **CE-MCP (default)** | **Full Mode (legacy)** | **Prompt-Only** |
185
+ | --------------------- | ---------------------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------- |
186
+ | **Requires API key?** | No | Yes (`OPENROUTER_API_KEY`) | No |
187
+ | **Returns** | Orchestration directives for the host LLM to execute | Server-side AI analysis results | Prompts you can paste into any AI chat |
188
+ | **Set via** | Default (no env var needed) | `EXECUTION_MODE=full` | `EXECUTION_MODE=prompt-only` |
189
+ | **Best for** | All users — recommended | Legacy workflows with dedicated API budget | Offline exploration |
190
+ | **Tools available** | All 64 tools with annotated MCP metadata | All 64 tools | Analysis prompts, templates, local file operations, ADR discovery |
188
191
 
189
192
  **What are CE-MCP directives?** When a tool is called, it returns a structured orchestration directive that tells your host LLM what to analyze, what data to gather, and how to format results. The host LLM (e.g. Claude in Claude Desktop, or GPT in Cursor) executes the directive using its existing context window. This means **zero additional API costs** and **better results** because the LLM already has your conversation context.
190
193
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "mcp-adr-analysis-server",
3
3
  "mcpName": "io.github.tosin2013/mcp-adr-analysis-server",
4
- "version": "2.14.6",
4
+ "version": "2.14.7",
5
5
  "description": "MCP server for analyzing Architectural Decision Records and project architecture",
6
6
  "main": "dist/src/index.js",
7
7
  "type": "module",