@rag-forge/mcp 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Femi Adedayo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# @rag-forge/mcp
+
+> Model Context Protocol server exposing RAG-Forge pipeline operations as agent-callable tools.
+
+`@rag-forge/mcp` is the MCP (Model Context Protocol) server for RAG-Forge. It lets agents — Claude Desktop, Claude Code, Copilot CLI, Cursor, or any MCP-compatible client — query a RAG pipeline, run audits, score against the RAG Maturity Model, and inspect indexed chunks without leaving the conversation.
+
+## Install
+
+```bash
+npm install -g @rag-forge/mcp
+# or
+pnpm add -g @rag-forge/mcp
+```
+
+You also need the Python runtime that powers the actual pipeline:
+
+```bash
+uv pip install rag-forge-core rag-forge-evaluator rag-forge-observability
+```
+
+## Run as an MCP server
+
+### stdio transport (Claude Desktop, Cursor)
+
+Add to your Claude Desktop config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "rag-forge": {
+      "command": "rag-forge-mcp",
+      "args": ["--stdio"]
+    }
+  }
+}
+```
+
+### HTTP transport (web agents, MCP gateways)
+
+```bash
+rag-forge-mcp --port 3100
+```
+
+Then point your MCP client at `http://localhost:3100/mcp`.
+
+### From the main CLI
+
+If you have `@rag-forge/cli` installed, you can also start the MCP server through it:
+
+```bash
+rag-forge serve --mcp --stdio
+# or
+rag-forge serve --mcp --port 3100
+```
+
+## What the agent can do
+
+Once connected, the agent gains these tools:
+
+| Tool | Purpose |
+|---|---|
+| `rag_forge_query` | Run a RAG query against the indexed corpus and return retrieved chunks + generated answer |
+| `rag_forge_audit` | Run an evaluation audit against telemetry or a golden set, returning RMM level + metric scores |
+| `rag_forge_cost` | Estimate the cost of a planned audit before running it |
+| `rag_forge_inspect` | Inspect indexed chunks, embedding stats, and retrieval results for a query |
+| `rag_forge_drift_report` | Compare current pipeline state against a saved baseline |
+| `rag_forge_golden_add` | Add a new question/answer pair to the golden set |
+| `rag_forge_assess` | One-shot RMM assessment without running a full audit |
+
+All tools return structured JSON the agent can reason about — perfect for agentic debugging loops where the model decides which audit to run, interprets the report, and proposes the next experiment.
+
+## Project context
+
+Run from inside a RAG-Forge project directory (one with a `rag-forge.config.ts` at the root). The MCP server reads that config to know which vector store, embedding model, and judge to use.
+
+## Documentation
+
+- **Full docs:** [github.com/hallengray/rag-forge](https://github.com/hallengray/rag-forge#readme)
+- **MCP overview:** [github.com/hallengray/rag-forge/blob/main/apps/docs/content/mcp/overview.mdx](https://github.com/hallengray/rag-forge/blob/main/apps/docs/content/mcp/overview.mdx)
+- **Issues:** [github.com/hallengray/rag-forge/issues](https://github.com/hallengray/rag-forge/issues)
+
+## License
+
+MIT — Femi Adedayo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rag-forge/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server exposing RAG-Forge pipeline operations as agent-callable tools",
   "author": "Femi Adedayo",
   "repository": {
@@ -27,19 +27,14 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
-  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@rag-forge/shared": "workspace:*",
-    "zod": "^3.23.0"
+    "zod": "^3.23.0",
+    "@rag-forge/shared": "0.1.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.0.0",
@@ -53,5 +48,13 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}