@agentbrain/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,578 @@
+# @agentbrain/mcp-server
+
+Model Context Protocol (MCP) server for AgentBrain - connect your AI agent directly to repository intelligence.
+
+## What is This?
+
+This MCP server lets **Claude Desktop**, **Cursor**, and **Windsurf** access AgentBrain functionality directly from within your coding sessions. Your AI agent can automatically:
+
+- 🔍 Scan your repository structure
+- 📖 Load comprehensive codebase context
+- 📋 Read coding standards
+- 💾 Save session handoffs
+
+**No CLI commands needed** - your agent does it all automatically!
+
+---
+
+## Installation
+
+```bash
+npm install -g @agentbrain/mcp-server
+```
+
+---
+
+## Setup by Platform
+
+### 🟣 Claude Desktop
+
+#### Step 1: Find the Server Path
+
+```bash
+which agentbrain-mcp
+```
+
+**Example output:**
+```
+/Users/yourname/.nvm/versions/node/v20.19.4/bin/agentbrain-mcp
+```
+
+**Copy this exact path** - you'll need it in the next step.
+
+#### Step 2: Edit Claude Desktop Config
+
+**macOS:**
+```bash
+# Open in your text editor
+code ~/Library/Application\ Support/Claude/claude_desktop_config.json
+
+# Or use nano
+nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
+```
+
+**Windows:**
+```bash
+# The config is at:
+%APPDATA%\Claude\claude_desktop_config.json
+```
+
+#### Step 3: Add AgentBrain to Config
+
+Add this configuration (use the path from Step 1):
+
+```json
+{
+  "mcpServers": {
+    "agentbrain": {
+      "command": "/Users/yourname/.nvm/versions/node/v20.19.4/bin/agentbrain-mcp"
+    }
+  }
+}
+```
+
+**⚠️ Important:** Use the **absolute path** you got from `which agentbrain-mcp`.
+
+**If you have other MCP servers already:**
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
+    },
+    "agentbrain": {
+      "command": "/Users/yourname/.nvm/versions/node/v20.19.4/bin/agentbrain-mcp"
+    }
+  }
+}
+```
+
+#### Step 4: Restart Claude Desktop
+
+**Completely quit** Claude Desktop (don't just close the window):
+- macOS: `Cmd + Q` or Claude → Quit Claude
+- Windows: Right-click taskbar icon → Quit
+
+Then reopen it.
+
+#### Step 5: Verify It's Working
+
+1. Start a new conversation in Claude Desktop
+2. Look for the **🔌 icon** in the toolbar or bottom of the chat
+3. Click it - you should see "agentbrain" with 4 tools:
+   - `scan_repo`
+   - `load_context`
+   - `load_standards`
+   - `save_handoff`
+
+#### Step 6: Try It Out!
+
+Ask Claude:
+```
+"Use the scan_repo tool to analyze my project at /Users/yourname/my-project"
+```
+
+Claude will automatically use the AgentBrain tools!
+
+---
+
+### 🔵 Cursor
+
+#### Step 1: Find the Server Path
+
+```bash
+which agentbrain-mcp
+```
+
+Copy the output path.
+
+#### Step 2: Open Cursor MCP Settings
+
+1. Open Cursor
+2. Press `Cmd + Shift + P` (macOS) or `Ctrl + Shift + P` (Windows/Linux)
+3. Type "MCP" and select **"MCP: Configure Servers"**
+
+Or manually edit the config file:
+
+**macOS:**
+```bash
+code ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+```
+
+**Linux:**
+```bash
+code ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+```
+
+**Windows:**
+```bash
+code %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
+```
+
+#### Step 3: Add AgentBrain Configuration
+
+```json
+{
+  "mcpServers": {
+    "agentbrain": {
+      "command": "/Users/yourname/.nvm/versions/node/v20.19.4/bin/agentbrain-mcp"
+    }
+  }
+}
+```
+
+#### Step 4: Restart Cursor
+
+Completely quit and reopen Cursor.
+
+#### Step 5: Verify
+
+1. Open a project in Cursor
+2. Open the Cursor chat (usually `Cmd + L` or `Ctrl + L`)
+3. Type `@` and you should see MCP tools available
+4. Or check the MCP panel in settings
+
+#### Step 6: Use It
+
+In Cursor chat:
+```
+"Scan the current repository using AgentBrain"
+```
+
+Cursor will automatically use the MCP tools!
+
+---
+
+### 🟢 Windsurf
+
+#### Step 1: Find the Server Path
+
+```bash
+which agentbrain-mcp
+```
+
+Copy the output path.
+
+#### Step 2: Open Windsurf Settings
+
+**Method 1: Via UI**
+1. Open Windsurf
+2. Go to Settings (gear icon)
+3. Search for "MCP" or "Model Context Protocol"
+4. Add new server configuration
+
+**Method 2: Edit Config File**
+
+**macOS:**
+```bash
+code ~/Library/Application\ Support/Windsurf/User/globalStorage/windsurf-mcp/settings.json
+```
+
+**Linux:**
+```bash
+code ~/.config/Windsurf/User/globalStorage/windsurf-mcp/settings.json
+```
+
+**Windows:**
+```bash
+code %APPDATA%\Windsurf\User\globalStorage\windsurf-mcp\settings.json
+```
+
+#### Step 3: Add AgentBrain
+
+```json
+{
+  "mcpServers": {
+    "agentbrain": {
+      "command": "/Users/yourname/.nvm/versions/node/v20.19.4/bin/agentbrain-mcp"
+    }
+  }
+}
+```
+
+#### Step 4: Restart Windsurf
+
+Quit completely and reopen.
+
+#### Step 5: Verify & Use
+
+Look for MCP tools in the Windsurf interface, then ask:
+```
+"Use AgentBrain to scan this project"
+```
+
+---
+
+## Available Tools
+
+Once configured, your agent can use these 4 tools:
+
+### 1. `scan_repo` - Analyze Repository Structure
+
+**What it does:** Scans your repository and lists all relevant files with language and size info.
+
+**Example prompts for your agent:**
+- "Scan this repository at /path/to/project"
+- "Show me the structure of my codebase"
+- "What files are in this project?"
+
+**Cost:** Free - no API calls
+
+---
+
+### 2. `load_context` - Load Full Context
+
+**What it does:** Loads comprehensive documentation about your entire codebase (context.md + dependency-map.md + patterns.md).
+
+**Example prompts:**
+- "Load the context for /path/to/project"
+- "Give me the full context of this codebase"
+- "Load project intelligence for my app"
+
+**Cost:**
+- **First time:** ~$0.02-0.05 (generates documentation)
+- **After that:** $0.00 (uses cache)
+
+**Note:** If the context doesn't exist, it will generate it using your API key.
+
+---
+
+### 3. `load_standards` - Load Coding Standards
+
+**What it does:** Loads the coding standards file for your specific agent (CLAUDE.md, .cursor/rules, or .windsurfrules).
+
+**Example prompts:**
+- "Load the coding standards for this project"
+- "What are my code standards?"
+- "Show me the project conventions"
+
+**Cost:** Free - reads from disk
+
+**Note:** Standards file must exist (create with `agentbrain standards` CLI command first).
+
+---
+
+### 4. `save_handoff` - Save Session Handoff
+
+**What it does:** Analyzes your recent git changes and creates a handoff document for the next session.
+
+**Example prompts:**
+- "Save a handoff for this session"
+- "Create a handoff document with goal: implemented auth"
+- "Generate a session summary"
+
+**Cost:** ~$0.01
+
+---
+
+## Complete Workflow Example
+
+### Morning: Start Your Day
+
+```
+You: "Load the context for /Users/me/my-app"
+Agent: *Uses load_context tool*
+Agent: "I've loaded the full context. Your app is a React/TypeScript
+       project with 47 files. I can see you have authentication,
+       user management, and API integration modules..."
+
+You: "What are the coding standards?"
+Agent: *Uses load_standards tool*
+Agent: "I've loaded the standards. You're using TypeScript with strict
+       mode, Prettier for formatting, and following clean architecture
+       patterns..."
+```
+
+### During Development
+
+```
+You: "Help me add a new feature for user notifications"
+Agent: *Already has full context from earlier*
+Agent: "Based on your current architecture, I recommend adding a
+       NotificationService class in src/services/..."
+```
+
+### End of Day
+
+```
+You: "Save a handoff with goal: Implemented notification system"
+Agent: *Uses save_handoff tool*
+Agent: "Handoff saved to agentbrain/handoff.md!
+       Summary: Added NotificationService, integrated with existing
+       user system, added tests. Next steps: Add email integration
+       and push notification support."
+```
+
+---
+
+## Troubleshooting
+
+### "AgentBrain not showing up in my agent"
+
+**1. Check the path is correct:**
+```bash
+which agentbrain-mcp
+# Copy this exact path to your config
+```
+
+**2. Verify config file location:**
+
+**Claude Desktop (macOS):**
+```bash
+cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
+```
+
+**3. Check for JSON syntax errors:**
+- Missing commas between entries
+- Missing quotes
+- Invalid path format
+
+**4. Restart completely:**
+- Don't just close the window
+- Actually quit the application (Cmd+Q / Ctrl+Q)
+- Reopen
+
+**5. Check logs:**
+
+**Claude Desktop:**
+- Go to Help → Show Logs (or Developer → Show Logs)
+- Look for MCP connection errors
+
+---
+
+### "Tool calls are failing"
+
+**1. Check the path exists:**
+```bash
+# Verify the repository exists
+ls ~/my-project  # or whatever path you're using
+```
+
+**2. Check API key for generation:**
+
+If loading context for the first time:
+```bash
+# Check if key exists
+echo $ANTHROPIC_API_KEY
+
+# Or
+agentbrain config --show
+```
+
+**3. Check the repo exists:**
+```bash
+ls /path/to/your/project
+```
+
+---
+
+### "Command not found: agentbrain-mcp"
+
+```bash
+# Reinstall
+npm install -g @agentbrain/mcp-server
+
+# Verify
+which agentbrain-mcp
+```
+
+---
+
+### "Getting 'permission denied' errors"
+
+```bash
+# Check file permissions
+ls -la $(which agentbrain-mcp)
+
+# Should be executable (has 'x' in permissions)
+# If not, fix it:
+chmod +x $(which agentbrain-mcp)
+```
+
+---
+
+## Configuration Examples
+
+### Minimal Configuration
+
+```json
+{
+  "mcpServers": {
+    "agentbrain": {
+      "command": "/absolute/path/to/agentbrain-mcp"
+    }
+  }
+}
+```
+
+### With Environment Variables
+
+```json
+{
+  "mcpServers": {
+    "agentbrain": {
+      "command": "/absolute/path/to/agentbrain-mcp",
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+### Multiple MCP Servers
+
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
+    },
+    "agentbrain": {
+      "command": "/Users/me/.nvm/versions/node/v20.19.4/bin/agentbrain-mcp"
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "ghp_..."
+      }
+    }
+  }
+}
+```
+
+---
+
+## Tips for Best Results
+
+### 1. Generate Context First
+
+Before using the MCP server, generate context once via CLI:
+
+```bash
+cd /path/to/project
+agentbrain init
+```
+
+This creates the cache, making MCP tool calls instant and free.
+
+### 2. Paths Are Flexible
+
+AgentBrain automatically handles different path formats:
+```
+✅ "Load context for /Users/me/my-project"   (absolute)
+✅ "Load context for ~/my-project"           (~ expansion)
+✅ "Load context for ../my-project"          (relative)
+```
+
+All three work! The MCP server automatically expands them.
+
+### 3. Generate Standards
+
+Create standards files so `load_standards` works:
+```bash
+cd /path/to/project
+agentbrain standards
+```
+
+### 4. Morning Routine
+
+Start each day by asking:
+```
+"Load the context and standards for /Users/me/my-project"
+```
+
+This gives your agent full project awareness immediately.
+
+---
+
+## Frequently Asked Questions
+
+**Q: Does this cost money?**
+A: Depends on the tool:
+- `scan_repo` - Free
+- `load_standards` - Free
+- `load_context` (cached) - Free
+- `load_context` (first time) - ~$0.02-0.05
+- `save_handoff` - ~$0.01
+
+**Q: Where does it get the API key?**
+A: From environment variables (`ANTHROPIC_API_KEY` or `OPENAI_API_KEY`) or from `~/.agentbrain/config.json` (set via `agentbrain config`).
+
+**Q: Can I use this without the CLI?**
+A: Yes! The MCP server works standalone. But using the CLI once to generate initial context (`agentbrain init`) will make subsequent MCP calls free and instant.
+
+**Q: Which agent is best?**
+A: All three work great:
+- **Claude Desktop** - Native MCP support, excellent integration
+- **Cursor** - Popular for coding, good MCP support
+- **Windsurf** - Emerging option with MCP support
+
+**Q: How do I update?**
+```bash
+npm update -g @agentbrain/mcp-server
+```
+
+---
+
+## Related Packages
+
+- **[@agentbrain/cli](../cli)** - Generate context via command line
+- **[@agentbrain/core](../core)** - Core library for custom integrations
+
+---
+
+## Support
+
+- **Documentation:** [Main README](../../README.md)
+- **Issues:** [GitHub Issues](https://github.com/yourusername/agentbrain/issues)
+- **MCP Protocol:** [modelcontextprotocol.io](https://modelcontextprotocol.io)
+
+---
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+// AgentBrain MCP Server
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { scanRepo, scanRepoSchema } from './tools/scan-repo.js';
+import { loadStandards, loadStandardsSchema } from './tools/load-standards.js';
+import { loadContext, loadContextSchema } from './tools/load-context.js';
+import { saveHandoff, saveHandoffSchema } from './tools/save-handoff.js';
+// Create MCP server
+const server = new Server({
+    name: 'agentbrain',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Register tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [scanRepoSchema, loadStandardsSchema, loadContextSchema, saveHandoffSchema],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'scan_repo': {
+                const result = await scanRepo(args);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'load_standards': {
+                const result = await loadStandards(args);
+                return {
+                    content: [{ type: 'text', text: result.content }],
+                };
+            }
+            case 'load_context': {
+                const result = await loadContext(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${result.content}\n\n---\n\n[Loaded from ${result.fromCache ? 'cache' : 'fresh generation'}, tokens used: ${result.tokensUsed}]`,
+                        },
+                    ],
+                };
+            }
+            case 'save_handoff': {
+                const result = await saveHandoff(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Handoff saved to ${result.filePath}\n\nTokens used: ${result.tokensUsed}\n\n---\n\n${result.content}`,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr so it doesn't interfere with MCP protocol on stdout
+    console.error('AgentBrain MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/load-context.d.ts

@@ -0,0 +1,29 @@
+export interface LoadContextInput {
+    repo_path: string;
+    force_refresh?: boolean;
+}
+export interface LoadContextOutput {
+    content: string;
+    fromCache: boolean;
+    tokensUsed: number;
+}
+export declare function loadContext(input: LoadContextInput): Promise<LoadContextOutput>;
+export declare const loadContextSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            repo_path: {
+                type: string;
+                description: string;
+            };
+            force_refresh: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=load-context.d.ts.map

package/dist/tools/load-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-context.d.ts","sourceRoot":"","sources":["../../src/tools/load-context.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiErF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAkB7B,CAAA"}

package/dist/tools/load-context.js

@@ -0,0 +1,86 @@
+// MCP tool: load_context - load context docs at session start
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { loadAIConfig, generateContext, getCachedDoc, getGitHash } from '@agentbrain/core';
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    return resolve(path);
+}
+export async function loadContext(input) {
+    const { repo_path, force_refresh = false } = input;
+    // Expand path to handle ~, relative paths, etc.
+    const expandedPath = expandPath(repo_path);
+    const contextDir = join(expandedPath, 'agentbrain');
+    // Try to load from disk first
+    const contextPath = join(contextDir, 'context.md');
+    const depMapPath = join(contextDir, 'dependency-map.md');
+    const patternsPath = join(contextDir, 'patterns.md');
+    const allExist = existsSync(contextPath) && existsSync(depMapPath) && existsSync(patternsPath);
+    if (!force_refresh && allExist) {
+        // Load from disk
+        const context = await readFile(contextPath, 'utf-8');
+        const depMap = await readFile(depMapPath, 'utf-8');
+        const patterns = await readFile(patternsPath, 'utf-8');
+        const combined = `# Repository Context\n\n${context}\n\n---\n\n# Dependency Map\n\n${depMap}\n\n---\n\n# Patterns\n\n${patterns}`;
+        return {
+            content: combined,
+            fromCache: true,
+            tokensUsed: 0,
+        };
+    }
+    // Need to generate - requires API key
+    const aiConfig = await loadAIConfig();
+    const gitHash = await getGitHash(expandedPath);
+    // Check cache validity
+    const cachedContext = await getCachedDoc(expandedPath, gitHash, 'context');
+    const cachedDepMap = await getCachedDoc(expandedPath, gitHash, 'dependency-map');
+    const cachedPatterns = await getCachedDoc(expandedPath, gitHash, 'patterns');
+    if (!force_refresh && cachedContext && cachedDepMap && cachedPatterns) {
+        const combined = `# Repository Context\n\n${cachedContext.content}\n\n---\n\n# Dependency Map\n\n${cachedDepMap.content}\n\n---\n\n# Patterns\n\n${cachedPatterns.content}`;
+        return {
+            content: combined,
+            fromCache: true,
+            tokensUsed: 0,
+        };
+    }
+    // Generate new context
+    const result = await generateContext({
+        repoPath: expandedPath,
+        aiConfig,
+        useCache: !force_refresh,
+    });
+    const combined = result.docs
+        .map((doc) => `# ${doc.type}\n\n${doc.content}`)
+        .join('\n\n---\n\n');
+    return {
+        content: combined,
+        fromCache: false,
+        tokensUsed: result.totalTokens,
+    };
+}
+export const loadContextSchema = {
+    name: 'load_context',
+    description: 'Load combined context documentation (context.md + dependency-map.md + patterns.md). Cached by git hash - repeat calls are free.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to the repository',
+            },
+            force_refresh: {
+                type: 'boolean',
+                description: 'Force regeneration even if cache is valid (default: false)',
+            },
+        },
+        required: ['repo_path'],
+    },
+};
+//# sourceMappingURL=load-context.js.map

package/dist/tools/load-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-context.js","sourceRoot":"","sources":["../../src/tools/load-context.ts"],"names":[],"mappings":"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"}

package/dist/tools/load-standards.d.ts

@@ -0,0 +1,31 @@
+import type { AgentTarget } from '@agentbrain/core';
+export interface LoadStandardsInput {
+    repo_path: string;
+    agent: AgentTarget;
+}
+export interface LoadStandardsOutput {
+    content: string;
+    filePath: string;
+    agent: AgentTarget;
+}
+export declare function loadStandards(input: LoadStandardsInput): Promise<LoadStandardsOutput>;
+export declare const loadStandardsSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            repo_path: {
+                type: string;
+                description: string;
+            };
+            agent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=load-standards.d.ts.map

package/dist/tools/load-standards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-standards.d.ts","sourceRoot":"","sources":["../../src/tools/load-standards.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAYnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsB3F;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;CAmB/B,CAAA"}

package/dist/tools/load-standards.js

@@ -0,0 +1,51 @@
+// MCP tool: load_standards - read standards file for an agent
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { AGENT_FILE_PATHS } from '@agentbrain/core';
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    return resolve(path);
+}
+export async function loadStandards(input) {
+    const { repo_path, agent } = input;
+    // Expand path to handle ~, relative paths, etc.
+    const expandedPath = expandPath(repo_path);
+    const relativePath = AGENT_FILE_PATHS[agent];
+    const filePath = join(expandedPath, relativePath);
+    if (!existsSync(filePath)) {
+        throw new Error(`Standards file not found: ${relativePath}. Run "agentbrain standards" to generate it.`);
+    }
+    const content = await readFile(filePath, 'utf-8');
+    return {
+        content,
+        filePath: relativePath,
+        agent,
+    };
+}
+export const loadStandardsSchema = {
+    name: 'load_standards',
+    description: 'Load coding standards file for a specific agent (Claude Code, Cursor, or Windsurf). Reads from disk - no AI call needed.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to the repository',
+            },
+            agent: {
+                type: 'string',
+                enum: ['claude-code', 'cursor', 'windsurf'],
+                description: 'Which agent to load standards for',
+            },
+        },
+        required: ['repo_path', 'agent'],
+    },
+};
+//# sourceMappingURL=load-standards.js.map

package/dist/tools/load-standards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-standards.js","sourceRoot":"","sources":["../../src/tools/load-standards.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGnD;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAElC,gDAAgD;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAE1C,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAEjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,6BAA6B,YAAY,8CAA8C,CACxF,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAEjD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,YAAY;QACtB,KAAK;KACN,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,0HAA0H;IAC5H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC;gBAC3C,WAAW,EAAE,mCAAmC;aACjD;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;KACjC;CACF,CAAA"}

package/dist/tools/save-handoff.d.ts

@@ -0,0 +1,29 @@
+export interface SaveHandoffInput {
+    repo_path: string;
+    goal?: string;
+}
+export interface SaveHandoffOutput {
+    content: string;
+    filePath: string;
+    tokensUsed: number;
+}
+export declare function saveHandoff(input: SaveHandoffInput): Promise<SaveHandoffOutput>;
+export declare const saveHandoffSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            repo_path: {
+                type: string;
+                description: string;
+            };
+            goal: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=save-handoff.d.ts.map

package/dist/tools/save-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-handoff.d.ts","sourceRoot":"","sources":["../../src/tools/save-handoff.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8BrF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAkB7B,CAAA"}

package/dist/tools/save-handoff.js

@@ -0,0 +1,59 @@
+// MCP tool: save_handoff - save handoff at session end
+import { writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { loadAIConfig, generateHandoff } from '@agentbrain/core';
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    return resolve(path);
+}
+export async function saveHandoff(input) {
+    const { repo_path, goal } = input;
+    // Expand path to handle ~, relative paths, etc.
+    const expandedPath = expandPath(repo_path);
+    // Load AI config
+    const aiConfig = await loadAIConfig();
+    // Generate handoff
+    const result = await generateHandoff({
+        repoPath: expandedPath,
+        aiConfig,
+        goal,
+    });
+    // Write to disk
+    const outputDir = join(expandedPath, 'agentbrain');
+    if (!existsSync(outputDir)) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    const filePath = join(outputDir, 'handoff.md');
+    await writeFile(filePath, result.doc.content, 'utf-8');
+    return {
+        content: result.doc.content,
+        filePath: 'agentbrain/handoff.md',
+        tokensUsed: result.tokenCount,
+    };
+}
+export const saveHandoffSchema = {
+    name: 'save_handoff',
+    description: 'Generate and save handoff document from git diff and recent commits. Creates agentbrain/handoff.md with session summary.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to the repository',
+            },
+            goal: {
+                type: 'string',
+                description: 'Optional session goal or objective to include in handoff',
+            },
+        },
+        required: ['repo_path'],
+    },
+};
+//# sourceMappingURL=save-handoff.js.map

package/dist/tools/save-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-handoff.js","sourceRoot":"","sources":["../../src/tools/save-handoff.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEhE;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAEjC,gDAAgD;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAE1C,iBAAiB;IACjB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAA;IAErC,mBAAmB;IACnB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,QAAQ,EAAE,YAAY;QACtB,QAAQ;QACR,IAAI;KACL,CAAC,CAAA;IAEF,gBAAgB;IAChB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAClD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;IAC9C,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAEtD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;QAC3B,QAAQ,EAAE,uBAAuB;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,0HAA0H;IAC5H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAA"}

package/dist/tools/scan-repo.d.ts

@@ -0,0 +1,33 @@
+export interface ScanRepoInput {
+    repo_path: string;
+    max_files?: number;
+}
+export interface ScanRepoOutput {
+    totalFiles: number;
+    relevantFiles: Array<{
+        path: string;
+        language: string;
+        size: number;
+    }>;
+    scannedAt: string;
+}
+export declare function scanRepo(input: ScanRepoInput): Promise<ScanRepoOutput>;
+export declare const scanRepoSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            repo_path: {
+                type: string;
+                description: string;
+            };
+            max_files: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=scan-repo.d.ts.map

package/dist/tools/scan-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-repo.d.ts","sourceRoot":"","sources":["../../src/tools/scan-repo.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;IACF,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAiB5E;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAkB1B,CAAA"}

package/dist/tools/scan-repo.js

@@ -0,0 +1,49 @@
+// MCP tool: scan_repo - inspect repo structure (no API key needed)
+import { scanRepository } from '@agentbrain/core';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    // Expand ~ to home directory
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    // Resolve relative paths
+    return resolve(path);
+}
+export async function scanRepo(input) {
+    const { repo_path, max_files = 100 } = input;
+    // Expand path to handle ~, relative paths, etc.
+    const expandedPath = expandPath(repo_path);
+    const result = await scanRepository(expandedPath, { maxFiles: max_files });
+    return {
+        totalFiles: result.totalFiles,
+        relevantFiles: result.relevantFiles.map((f) => ({
+            path: f.path,
+            language: f.language,
+            size: f.size,
+        })),
+        scannedAt: result.scannedAt,
+    };
+}
+export const scanRepoSchema = {
+    name: 'scan_repo',
+    description: 'Inspect repository structure and get list of relevant files. No API key required - pure file analysis.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to the repository',
+            },
+            max_files: {
+                type: 'number',
+                description: 'Maximum number of files to analyze (default: 100)',
+            },
+        },
+        required: ['repo_path'],
+    },
+};
+//# sourceMappingURL=scan-repo.js.map

package/dist/tools/scan-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-repo.js","sourceRoot":"","sources":["../../src/tools/scan-repo.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,6BAA6B;IAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,yBAAyB;IACzB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC;AAiBD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAoB;IACjD,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,KAAK,CAAA;IAE5C,gDAAgD;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAE1C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAA;IAE1E,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC;QACH,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,wGAAwG;IAC1G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAA"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@agentbrain/mcp-server",
+  "version": "1.0.0",
+  "description": "Model Context Protocol server for AgentBrain - connect Claude, Cursor, and Windsurf to repository intelligence",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "agentbrain-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "context",
+    "claude",
+    "cursor",
+    "windsurf",
+    "coding-agent",
+    "agentbrain"
+  ],
+  "author": "AgentBrain",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/agentbrain.git",
+    "directory": "packages/mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/agentbrain/issues"
+  },
+  "homepage": "https://github.com/yourusername/agentbrain#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@agentbrain/core": "*",
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "typescript": "^5.7.2"
+  }
+}