@contextos/mcp 0.2.0 → 0.3.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @contextos/mcp@0.1.0 build C:\Users\ixayl\Desktop\ContextOS\ContextOS\packages\mcp
+> @contextos/mcp@0.3.0 build C:\Users\ixayl\Desktop\ContextOS\ContextOS\packages\mcp
 > tsup src/index.ts --format esm --clean
 
 CLI Building entry: src/index.ts
@@ -8,5 +8,5 @@
 CLI Target: es2022
 CLI Cleaning output folder
 ESM Build start
-ESM dist\index.js 19.58 KB
-ESM ⚡️ Build success in 1395ms
+ESM dist\index.js 19.69 KB
+ESM ⚡️ Build success in 338ms

package/README.md

@@ -1,63 +1,52 @@
-# ContextOS MCP Server
+# @contextos/mcp
 
-Model Context Protocol (MCP) server that enables AI tools like **Claude Code**, **Cursor**, **Windsurf** to access optimized context from ContextOS.
+**Model Context Protocol server for ContextOS**
 
-## Features
+[![npm version](https://img.shields.io/npm/v/@contextos/mcp?style=flat-square)](https://www.npmjs.com/package/@contextos/mcp)
 
-### 🔧 Tools
-AI can perform these actions:
+Enables AI coding tools to access ContextOS's optimized context through the [Model Context Protocol](https://modelcontextprotocol.io/).
 
-| Tool | Description |
-|------|-------------|
-| `contextos_build` | Build optimized context for a goal |
-| `contextos_analyze` | Deep RLM-powered analysis |
-| `contextos_find` | Find files by pattern |
-| `contextos_deps` | Get file dependencies |
-| `contextos_explain` | Get file explanation |
-| `contextos_status` | Check ContextOS status |
+## 🎯 Supported Tools
 
-### 📚 Resources
-AI can read these data sources:
+| Tool | Integration |
+|------|-------------|
+| Claude Desktop | ✅ Native MCP |
+| Claude Code CLI | ✅ Native MCP |
+| Cursor | ✅ Native MCP |
+| Windsurf | ✅ Native MCP |
+| Kilo Code | ✅ Native MCP |
+| VS Code + Continue.dev | ✅ Native MCP |
 
-| Resource | Description |
-|----------|-------------|
-| `contextos://context/current` | Last built context |
-| `contextos://project/info` | Project configuration |
-| `contextos://project/constraints` | Coding rules |
-| `contextos://project/structure` | Directory tree |
+## 🚀 Quick Setup
 
-### 💬 Prompts
-Pre-built prompt templates:
+### Recommended: Use Universal Setup
 
-| Prompt | Description |
-|--------|-------------|
-| `code_with_context` | Start coding with context |
-| `review_code` | Review file with deps |
-| `debug_issue` | Debug with context |
+```bash
+npx @contextos/setup
+```
 
----
+This automatically configures all your AI tools.
 
-## Installation
+### Manual Configuration
 
-### For Claude Desktop
+#### Claude Desktop / Claude Code CLI
 
-Add to your Claude Desktop config (`claude_desktop_config.json`):
+Add to `~/.config/claude/claude_desktop_config.json` (Linux/macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
 ```json
 {
   "mcpServers": {
     "contextos": {
       "command": "npx",
-      "args": ["@contextos/mcp"],
-      "cwd": "/path/to/your/project"
+      "args": ["-y", "@contextos/mcp"]
     }
   }
 }
 ```
 
-### For Cursor
+#### Cursor
 
-Add to Cursor settings:
+Add to settings.json:
 
 ```json
 {
@@ -70,52 +59,139 @@ Add to Cursor settings:
 }
 ```
 
-### Global Installation
+#### Windsurf
 
-```bash
-npm install -g @contextos/mcp
-contextos-mcp
+Add to settings.json:
+
+```json
+{
+  "mcp.servers": {
+    "contextos": {
+      "command": "npx @contextos/mcp",
+      "cwd": "${workspaceFolder}"
+    }
+  }
+}
 ```
 
----
+## 🔧 MCP Capabilities
 
-## Usage
+### Tools
 
-Once configured, the AI tool will automatically have access to ContextOS features.
+| Tool | Description |
+|------|-------------|
+| `contextos_build` | Build optimized context for a goal |
+| `contextos_analyze` | Deep analysis using RLM engine |
+| `contextos_find` | Find files matching a pattern |
+| `contextos_deps` | Get file dependencies |
+| `contextos_explain` | Explain a file's purpose |
+| `contextos_status` | Get ContextOS status |
+
+### Resources
+
+| Resource | Description |
+|----------|-------------|
+| `contextos://context/current` | Current built context |
+| `contextos://project/info` | Project information |
+| `contextos://project/constraints` | Coding constraints |
+| `contextos://project/structure` | File tree structure |
+
+### Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `code_with_context` | Start coding with full context |
+| `review_code` | Review code with dependencies |
+| `debug_issue` | Debug with relevant context |
+
+## 📋 Usage Examples
+
+Once configured, your AI assistant can use ContextOS automatically:
+
+**Example Chat:**
 
-### Example: Building Context
+```
+You: Add rate limiting to the AuthController
 
-The AI can call:
+AI: [Calls contextos_build("Add rate limiting to AuthController")]
+AI: Based on the context, I can see AuthController.ts imports RateLimitMiddleware...
+    Here's the implementation:
+    ...
 ```
-Use the contextos_build tool with goal "Add authentication to UserController"
+
+**Example with Tools:**
+
 ```
+You: What does PaymentService depend on?
 
-And receive optimized context automatically.
+AI: [Calls contextos_deps("src/payment/PaymentService.ts")]
+AI: PaymentService depends on:
+    - src/payment/StripeClient.ts
+    - src/user/UserRepository.ts
+    - src/common/Logger.ts
+```
 
-### Example: Reading Project Info
+## 🏗️ How It Works
 
-The AI can read:
 ```
-Read the contextos://project/info resource
+┌─────────────────────────────────────────────────────────────┐
+│                     AI Tool (Cursor, Claude, etc.)           │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              │ MCP Protocol
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    @contextos/mcp                            │
+│                                                              │
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐       │
+│  │    Tools     │  │  Resources   │  │   Prompts    │       │
+│  │  (Actions)   │  │   (Data)     │  │ (Templates)  │       │
+│  └──────────────┘  └──────────────┘  └──────────────┘       │
+│                              │                               │
+│                              ▼                               │
+│  ┌─────────────────────────────────────────────────────┐    │
+│  │                 @contextos/core                      │    │
+│  │  RLM Engine | Hybrid Ranker | Parser | Graph | etc.  │    │
+│  └─────────────────────────────────────────────────────┘    │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    Your Codebase                             │
+│  .contextos/ | src/ | package.json | ...                     │
+└─────────────────────────────────────────────────────────────┘
 ```
 
----
+## 🔍 Debugging
 
-## Development
+### Check if MCP server starts correctly
 
 ```bash
-# Install dependencies
-pnpm install
+npx @contextos/mcp
+```
+
+You should see: `ContextOS MCP Server started`
 
-# Build
-pnpm build
+### Enable debug logging
 
-# Run locally
-pnpm start
+```bash
+DEBUG=contextos:* npx @contextos/mcp
 ```
 
----
+### Check tool logs
+
+Most MCP-compatible tools have a developer console or log file where you can see MCP communication.
+
+## 📦 Requirements
+
+- Node.js 18+
+- A ContextOS-initialized project (`npx @contextos/cli init`)
+- An MCP-compatible AI tool
+
+## 🤝 Contributing
+
+Found an issue or want to add support for a new tool? Open an issue or PR!
 
-## License
+## 📄 License
 
-MIT
+MIT © ContextOS Team

package/dist/index.js

@@ -355,12 +355,15 @@ ${content.slice(0, 3e3)}
       /^import\s+([\w.]+)/gm,
       /^from\s+([\w.]+)\s+import/gm
     ];
+    const MAX_ITERATIONS = 1e3;
     for (const pattern of patterns) {
       let match;
-      while ((match = pattern.exec(content)) !== null) {
+      let iterations = 0;
+      while ((match = pattern.exec(content)) !== null && iterations < MAX_ITERATIONS) {
         if (match[1] && !imports.includes(match[1])) {
           imports.push(match[1]);
         }
+        iterations++;
       }
     }
     return `# Dependencies of ${file}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextos/mcp",
-  "version": "0.2.0",
-  "description": "Model Context Protocol server for ContextOS - enables AI tools to access optimized context",
+  "version": "0.3.1",
+  "description": "Model Context Protocol server for ContextOS - enables all AI tools (Claude, Cursor, Codex, Gemini, Windsurf) to access optimized context",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -9,7 +9,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^0.5.0",
-    "@contextos/core": "0.2.0"
+    "@contextos/core": "0.4.4"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
@@ -22,7 +22,11 @@
     "ai",
     "context",
     "cursor",
-    "claude"
+    "claude",
+    "codex",
+    "gemini",
+    "windsurf",
+    "contextos"
   ],
   "author": "ContextOS Team",
   "license": "MIT",

package/src/provider.ts

@@ -406,12 +406,17 @@ ${result.context}
             /^from\s+([\w.]+)\s+import/gm,
         ];
 
+        // Fix R3: Add maximum iterations to prevent ReDoS
+        const MAX_ITERATIONS = 1000;
+
         for (const pattern of patterns) {
             let match;
-            while ((match = pattern.exec(content)) !== null) {
+            let iterations = 0;
+            while ((match = pattern.exec(content)) !== null && iterations < MAX_ITERATIONS) {
                 if (match[1] && !imports.includes(match[1])) {
                     imports.push(match[1]);
                 }
+                iterations++;
             }
         }