merlin-mcp 0.2.0

package/README.md

@@ -0,0 +1,148 @@
+# merlin-mcp
+
+> MCP server that gives Claude Code instant access to your codebase context via merlin.build
+
+## What This Does
+
+Once installed, Claude Code automatically has deep understanding of any repository you've analyzed on [merlin.build](https://merlin.build):
+
+- **No more re-explaining** your codebase every session
+- **No more duplicating** code that already exists
+- **No more guessing** at patterns and conventions
+- **Instant context** for any task you're working on
+
+## Quick Start
+
+### 1. Analyze Your Repository
+
+Visit [merlin.build](https://merlin.build) and analyze your repository. This takes ~10 minutes and creates comprehensive documentation.
+
+### 2. Get Your API Key
+
+Go to [merlin.build/settings](https://merlin.build/settings) and generate an API key.
+
+### 3. Configure Claude Code
+
+Add to your Claude Code config (`~/.claude/config.json`):
+
+```json
+{
+  "mcpServers": {
+    "merlin": {
+      "command": "npx",
+      "args": ["merlin-mcp"],
+      "env": {
+        "MERLIN_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### 4. Use It
+
+Just start working. Claude Code now automatically has context:
+
+```
+> "Add a new API endpoint for user settings"
+
+Claude knows:
+- Where your existing endpoints are
+- What patterns they follow
+- What middleware to use
+- What utilities exist to reuse
+- What conventions to follow
+```
+
+## Available Tools
+
+Once connected, Claude Code has access to these tools:
+
+| Tool | Description |
+|------|-------------|
+| `merlin_get_context` | Get relevant context for a task (patterns, files, conventions) |
+| `merlin_find_files` | Find files by purpose or layer |
+| `merlin_get_conventions` | Get coding conventions and anti-patterns |
+| `merlin_quickstart` | Get a 60-second codebase overview |
+| `merlin_search` | Search documentation for specific topics |
+| `merlin_list_repos` | List your analyzed repositories |
+
+## How It Works
+
+1. **Auto-detection**: The MCP server detects which git repository you're in
+2. **Lookup**: It finds the matching analyzed repo on merlin.build
+3. **Context**: It provides relevant context to Claude Code
+4. **Caching**: Responses are cached for fast repeat access
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MERLIN_API_KEY` | Your Merlin API key | Required |
+| `MERLIN_API_URL` | API base URL | `https://api.merlin.build` |
+
+## Manual Usage
+
+You can also run the server directly:
+
+```bash
+# Show help
+npx merlin-mcp --help
+
+# Show version
+npx merlin-mcp --version
+
+# Run server (for testing)
+MERLIN_API_KEY=xxx npx merlin-mcp
+```
+
+## Troubleshooting
+
+### "Could not find repository"
+
+This means either:
+1. You're not in a git repository
+2. The repository hasn't been analyzed on merlin.build
+3. The git remote URL doesn't match what's on merlin
+
+**Solution**: Make sure the repo is analyzed at merlin.build and you're in the repo directory.
+
+### "API request failed: 401"
+
+Your API key is invalid or expired.
+
+**Solution**: Generate a new API key at merlin.build/settings.
+
+### Server not starting
+
+Check that Node.js 18+ is installed:
+
+```bash
+node --version  # Should be 18.x or higher
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in development
+npm run dev
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+MIT
+
+## Links
+
+- [merlin.build](https://merlin.build) - Analyze your repositories
+- [Documentation](https://merlin.build/docs) - Full documentation
+- [GitHub](https://github.com/merlin/merlin) - Source code

package/dist/api/client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * merlin API Client
+ * Handles all HTTP requests to the merlin API with caching and error handling
+ */
+import type { Repository, AgentManifest, ConventionsResponse, FilesResponse } from './types.js';
+/** API client configuration */
+interface ClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+}
+/** Merlin API Client */
+export declare class MerlinClient {
+    private config;
+    private cache;
+    private static MANIFEST_TTL;
+    private static CONVENTIONS_TTL;
+    private static REPOS_TTL;
+    private static FILES_TTL;
+    private static HOWTO_TTL;
+    constructor(config?: Partial<ClientConfig>);
+    /** Make an authenticated request to the API */
+    private fetch;
+    /** Get list of user's repositories */
+    getRepositories(): Promise<Repository[]>;
+    /** Find repository by GitHub URL */
+    findRepoByUrl(githubUrl: string): Promise<Repository | null>;
+    /** Get full manifest for a repository */
+    getManifest(repoId: string): Promise<AgentManifest>;
+    /** Get quickstart guide (text format) */
+    getQuickstart(repoId: string): Promise<string>;
+    /** Get main overview (text format) */
+    getOverview(repoId: string): Promise<string>;
+    /** Get conventions and anti-patterns */
+    getConventions(repoId: string): Promise<ConventionsResponse>;
+    /** Get files, optionally filtered by layer or purpose */
+    getFiles(repoId: string, options?: {
+        layer?: string;
+        purpose?: string;
+    }): Promise<FilesResponse>;
+    /** Find files by purpose (text format) */
+    findFiles(repoId: string, what: string): Promise<string>;
+    /** Search documentation */
+    search(repoId: string, query: string): Promise<string>;
+    /** Get how-to guide for a task */
+    getHowTo(repoId: string, task: string): Promise<string>;
+    /** Get impact analysis for a file - what depends on it */
+    getImpactAnalysis(repoId: string, filePath: string): Promise<string>;
+    /** Find similar code implementations */
+    getSimilarCode(repoId: string, description: string): Promise<string>;
+    /** Get code examples for common tasks */
+    getCodeExamples(repoId: string, task?: string): Promise<string>;
+    /** Clear all cached data */
+    clearCache(): void;
+}
+/** Get or create the API client instance */
+export declare function getClient(): MerlinClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAQpB,+BAA+B;AAC/B,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD,wBAAwB;AACxB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAe;IAG5B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAa;IACxC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAiB;IAC/C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAa;IACrC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAa;IACrC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiB;gBAE7B,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAO9C,+CAA+C;YACjC,KAAK;IA+BnB,sCAAsC;IAChC,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAW9C,oCAAoC;IAC9B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAsBlE,yCAAyC;IACnC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUzD,yCAAyC;IACnC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpD,sCAAsC;IAChC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlD,wCAAwC;IAClC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUlE,yDAAyD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAgB1G,0CAA0C;IACpC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,2BAA2B;IACrB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5D,kCAAkC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU7D,0DAA0D;IACpD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1E,wCAAwC;IAClC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1E,yCAAyC;IACnC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOrE,4BAA4B;IAC5B,UAAU,IAAI,IAAI;CAGnB;AAKD,4CAA4C;AAC5C,wBAAgB,SAAS,IAAI,YAAY,CAKxC"}

package/dist/api/client.js

@@ -0,0 +1,205 @@
+/**
+ * merlin API Client
+ * Handles all HTTP requests to the merlin API with caching and error handling
+ */
+/** Simple in-memory cache */
+class Cache {
+    store = new Map();
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return null;
+        }
+        return entry.data;
+    }
+    set(key, data, ttlMs) {
+        this.store.set(key, {
+            data,
+            expiresAt: Date.now() + ttlMs,
+        });
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+/** Merlin API Client */
+export class MerlinClient {
+    config;
+    cache = new Cache();
+    // Cache TTLs - short for real-time updates
+    static MANIFEST_TTL = 60 * 1000; // 1 minute (wiki updates every 5 min)
+    static CONVENTIONS_TTL = 5 * 60 * 1000; // 5 minutes
+    static REPOS_TTL = 30 * 1000; // 30 seconds (for share changes)
+    static FILES_TTL = 60 * 1000; // 1 minute (files rarely change mid-session)
+    static HOWTO_TTL = 2 * 60 * 1000; // 2 minutes (smart how-to has server-side cache too)
+    constructor(config = {}) {
+        this.config = {
+            baseUrl: config.baseUrl || process.env.MERLIN_API_URL || 'https://claude-codeapi-production.up.railway.app',
+            apiKey: config.apiKey || process.env.MERLIN_API_KEY,
+        };
+    }
+    /** Make an authenticated request to the API */
+    async fetch(path, options = {}) {
+        const url = `${this.config.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'User-Agent': 'merlin-mcp/0.1.0',
+            ...(options.headers || {}),
+        };
+        // Add API key if available
+        if (this.config.apiKey) {
+            headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+        }
+        const response = await fetch(url, {
+            ...options,
+            headers,
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => 'Unknown error');
+            throw new Error(`API request failed: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        // Handle both JSON and text responses
+        const contentType = response.headers.get('content-type');
+        if (contentType?.includes('application/json')) {
+            return response.json();
+        }
+        return response.text();
+    }
+    /** Get list of user's repositories */
+    async getRepositories() {
+        const cacheKey = 'repos';
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const response = await this.fetch('/api/repos/my/list');
+        const repos = response.repositories || [];
+        this.cache.set(cacheKey, repos, MerlinClient.REPOS_TTL);
+        return repos;
+    }
+    /** Find repository by GitHub URL */
+    async findRepoByUrl(githubUrl) {
+        const repos = await this.getRepositories();
+        // Normalize URL for comparison
+        const normalizeUrl = (url) => {
+            return url
+                .replace(/^https?:\/\//, '')
+                .replace(/^github\.com\//, '')
+                .replace(/\.git$/, '')
+                .toLowerCase();
+        };
+        const normalizedTarget = normalizeUrl(githubUrl);
+        return repos.find(repo => {
+            const normalizedRepo = normalizeUrl(repo.url);
+            return normalizedRepo === normalizedTarget ||
+                normalizedRepo.includes(normalizedTarget) ||
+                normalizedTarget.includes(normalizedRepo);
+        }) || null;
+    }
+    /** Get full manifest for a repository */
+    async getManifest(repoId) {
+        const cacheKey = `manifest:${repoId}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const manifest = await this.fetch(`/api/agent/${repoId}/manifest`);
+        this.cache.set(cacheKey, manifest, MerlinClient.MANIFEST_TTL);
+        return manifest;
+    }
+    /** Get quickstart guide (text format) */
+    async getQuickstart(repoId) {
+        const cacheKey = `quickstart:${repoId}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const quickstart = await this.fetch(`/api/agent/${repoId}/quickstart`);
+        this.cache.set(cacheKey, quickstart, MerlinClient.MANIFEST_TTL);
+        return quickstart;
+    }
+    /** Get main overview (text format) */
+    async getOverview(repoId) {
+        const cacheKey = `overview:${repoId}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const overview = await this.fetch(`/api/agent/${repoId}`);
+        this.cache.set(cacheKey, overview, MerlinClient.MANIFEST_TTL);
+        return overview;
+    }
+    /** Get conventions and anti-patterns */
+    async getConventions(repoId) {
+        const cacheKey = `conventions:${repoId}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const conventions = await this.fetch(`/api/agent/${repoId}/manifest/conventions`);
+        this.cache.set(cacheKey, conventions, MerlinClient.CONVENTIONS_TTL);
+        return conventions;
+    }
+    /** Get files, optionally filtered by layer or purpose */
+    async getFiles(repoId, options = {}) {
+        const params = new URLSearchParams();
+        if (options.layer)
+            params.set('layer', options.layer);
+        if (options.purpose)
+            params.set('purpose', options.purpose);
+        const queryString = params.toString();
+        const cacheKey = `files:${repoId}:${queryString}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const path = `/api/agent/${repoId}/manifest/files${queryString ? `?${queryString}` : ''}`;
+        const files = await this.fetch(path);
+        this.cache.set(cacheKey, files, MerlinClient.FILES_TTL);
+        return files;
+    }
+    /** Find files by purpose (text format) */
+    async findFiles(repoId, what) {
+        return this.fetch(`/api/agent/${repoId}/find/${encodeURIComponent(what)}`);
+    }
+    /** Search documentation */
+    async search(repoId, query) {
+        return this.fetch(`/api/agent/${repoId}/search?q=${encodeURIComponent(query)}`);
+    }
+    /** Get how-to guide for a task */
+    async getHowTo(repoId, task) {
+        const cacheKey = `howto:${repoId}:${task.toLowerCase().trim()}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const howto = await this.fetch(`/api/agent/${repoId}/howto?task=${encodeURIComponent(task)}`);
+        this.cache.set(cacheKey, howto, MerlinClient.HOWTO_TTL);
+        return howto;
+    }
+    /** Get impact analysis for a file - what depends on it */
+    async getImpactAnalysis(repoId, filePath) {
+        return this.fetch(`/api/agent/${repoId}/impact/${encodeURIComponent(filePath)}`);
+    }
+    /** Find similar code implementations */
+    async getSimilarCode(repoId, description) {
+        return this.fetch(`/api/agent/${repoId}/similar?q=${encodeURIComponent(description)}`);
+    }
+    /** Get code examples for common tasks */
+    async getCodeExamples(repoId, task) {
+        const path = task
+            ? `/api/agent/${repoId}/examples/${encodeURIComponent(task)}`
+            : `/api/agent/${repoId}/examples`;
+        return this.fetch(path);
+    }
+    /** Clear all cached data */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+/** Singleton instance */
+let clientInstance = null;
+/** Get or create the API client instance */
+export function getClient() {
+    if (!clientInstance) {
+        clientInstance = new MerlinClient();
+    }
+    return clientInstance;
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * API Response Types for Merlin
+ */
+/** Repository info from /api/repos */
+export interface Repository {
+    id: string;
+    name: string;
+    fullName: string;
+    url: string;
+    branch: string;
+    status: 'pending' | 'analyzing' | 'completed' | 'failed';
+    lastAnalyzedAt?: string;
+    createdAt: string;
+}
+/** File info from manifest */
+export interface FileInfo {
+    path: string;
+    purpose: string;
+    exports: Array<{
+        name: string;
+        type: string;
+    }>;
+    modifyFor: string[];
+    layer: string;
+}
+/** Convention from manifest */
+export interface Convention {
+    category: string;
+    rule: string;
+    example: string;
+    exampleFiles: string[];
+    enforcement: string;
+}
+/** Anti-pattern from manifest */
+export interface AntiPattern {
+    pattern: string;
+    reason: string;
+    instead: string;
+    severity: 'error' | 'warning';
+}
+/** Change guide step */
+export interface ChangeStep {
+    order: number;
+    file: string;
+    action: string;
+    description: string;
+    pattern: string;
+}
+/** Change guide from manifest */
+export interface ChangeGuide {
+    task: string;
+    description: string;
+    steps: ChangeStep[];
+    affectedFiles: string[];
+    conventions: string[];
+}
+/** Entry point from manifest */
+export interface EntryPoint {
+    name: string;
+    path: string;
+    purpose: string;
+    useCase: string;
+    relatedFiles: string[];
+}
+/** Full agent manifest response */
+export interface AgentManifest {
+    projectName: string;
+    description: string;
+    techStack: string[];
+    architecture: string;
+    entryPoints: EntryPoint[];
+    fileIndex: FileInfo[];
+    conventions: Convention[];
+    antiPatterns: AntiPattern[];
+    changeGuides: ChangeGuide[];
+    modules: Array<{
+        name: string;
+        path: string;
+        description: string;
+    }>;
+}
+/** Search result */
+export interface SearchResult {
+    type: 'SERVICE' | 'MODULE' | 'TERM' | 'FILE';
+    name: string;
+    description: string;
+    path?: string;
+}
+/** Conventions response */
+export interface ConventionsResponse {
+    conventions: Convention[];
+    antiPatterns: AntiPattern[];
+    changeGuides: ChangeGuide[];
+}
+/** Files response */
+export interface FilesResponse {
+    count: number;
+    files: FileInfo[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2BAA2B;AAC3B,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB"}

package/dist/api/types.js

@@ -0,0 +1,5 @@
+/**
+ * API Response Types for Merlin
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * Merlin MCP Server - Entry Point
+ *
+ * AI-powered codebase intelligence for coding agents.
+ * https://merlin.build
+ *
+ * Usage:
+ *   npx merlin-mcp
+ *   MERLIN_API_KEY=xxx npx merlin-mcp
+ *
+ * Configuration (via environment variables):
+ *   MERLIN_API_KEY - Your Merlin API key (required for private repos)
+ *   MERLIN_API_URL - API base URL (default: https://api.merlin.build)
+ */
+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":";AACA;;;;;;;;;;;;;GAaG"}