mne-docs-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 weiyongxu
+
+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,140 @@
+# MNE Docs MCP Server
+
+MCP server providing access to MNE-Python documentation, source code, GitHub issues, and community forum across the MNE ecosystem.
+
+## Quick Start
+
+```bash
+# Clone and install
+git clone https://github.com/weiyongxu/mne-docs-mcp.git
+cd mne-docs-mcp
+npm install
+
+# Set GitHub token (required)
+export MNE_GITHUB_TOKEN=ghp_your_token_here
+
+# Start server
+npm start
+```
+
+Server runs on `http://localhost:8000`. Verify with `curl http://localhost:8000/health`.
+
+## MCP Client Integration
+
+### Claude Desktop / Kiro / Claude Code
+
+Add to your MCP config (`claude_desktop_config.json`, `.kiro/settings/mcp.json`, or `~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "mne-docs": {
+      "command": "node",
+      "args": ["/path/to/mne-docs-mcp/dist/index.js"],
+      "env": {
+        "MNE_GITHUB_TOKEN": "ghp_your_token_here",
+        "MNE_TRANSPORT": "stdio"
+      }
+    }
+  }
+}
+```
+
+> **Windows:** Add `"MNE_PYTHON_PATH": "python"` to env.
+
+### HTTP Mode
+
+```bash
+MNE_TRANSPORT=http npm start
+# Connect to http://localhost:8000/mcp
+```
+
+### Docker
+
+```bash
+docker run -p 8000:8000 -e MNE_GITHUB_TOKEN=ghp_your_token mne-docs-mcp
+```
+
+### Docker Compose
+
+```bash
+# Set your token
+export MNE_GITHUB_TOKEN=ghp_your_token_here
+
+# Start
+docker-compose up -d
+
+# View logs
+docker-compose logs -f
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_mne_versions` | List available MNE releases |
+| `get_mne_file` | Fetch source code |
+| `get_mne_doc` | Get symbol documentation |
+| `find_mne_symbol` | Search for symbols |
+| `search_mne_docs` | Unified code/docs search |
+| `search_mne_issues` | Search GitHub issues |
+| `get_mne_issue` | Get issue details |
+| `get_mne_issue_comments` | Get issue comments |
+| `search_mne_forum` | Search community forum |
+| `get_mne_forum_topic` | Get full forum discussion |
+| `get_symbol_references` | Get callees/callers |
+| `get_related_symbols` | Find related functions |
+| `get_mne_changelog` | Get version changes |
+| `get_mne_example` | Get tutorial code |
+| `lookup_mne_error` | Diagnose MNE errors |
+
+All tools support a `package` parameter to query across the MNE ecosystem: `mne-python` (default), `mne-bids-pipeline`, `mne-bids`, `mne-connectivity`, `mne-nirs`, `mne-rsa`, `mne-icalabel`, `mne-realtime`, `mne-lsl`, `mne-gui-addons`.
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MNE_GITHUB_TOKEN` | GitHub PAT (required) | - |
+| `MNE_PORT` | Server port | `8000` |
+| `MNE_TRANSPORT` | `http` or `stdio` | `http` |
+| `MNE_PYTHON_PATH` | Python executable | `python3` |
+| `MNE_LOG_LEVEL` | `debug`/`info`/`warn`/`error` | `info` |
+
+See `.env.example` for all options including cache TTLs and timeouts.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  TypeScript Server (Node.js)                            │
+│  ├─ MCP Tools (McpServer API, SDK v1.18+)              │
+│  ├─ GitHub Client (rate limiting, caching)             │
+│  └─ Python Parser Bridge ──┐                            │
+└────────────────────────────┼────────────────────────────┘
+                             ▼
+                    ┌─────────────────┐
+                    │  Python Parser  │
+                    │  (AST, stdlib)  │
+                    └─────────────────┘
+```
+
+Built with the official [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk).
+
+## Development
+
+```bash
+npm run dev          # Watch mode
+npm run build        # Compile TypeScript
+npm test             # Run tests
+npm run lint         # ESLint
+```
+
+## Troubleshooting
+
+- **Rate limits:** Ensure `MNE_GITHUB_TOKEN` is set
+- **Parser fails:** Check Python 3 is installed; Windows users set `MNE_PYTHON_PATH=python`
+- **Test setup:** Run `npx tsx examples/mcp-client.ts` to verify
+
+## License
+
+MIT

package/dist/cache/manager.d.ts

@@ -0,0 +1,41 @@
+import { Config } from '../config.js';
+import { MneVersion, ParsedSymbol, SearchResult, ForumSearchItem } from '../types.js';
+export interface CacheEntry<T> {
+    data: T;
+    expiresAt: number;
+    lastAccessed: number;
+}
+export interface CacheStats {
+    entries: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+}
+export declare class CacheManager {
+    private config;
+    private logger;
+    private versionTtlMs;
+    private versions;
+    private fileCache;
+    private symbolCache;
+    private searchCache;
+    private forumCache;
+    constructor(config: Config);
+    getVersions(): MneVersion[] | null;
+    setVersions(versions: MneVersion[]): void;
+    getFile(version: string, path: string): string | null;
+    setFile(version: string, path: string, content: string): void;
+    getSymbol(version: string, symbol: string): ParsedSymbol | null;
+    setSymbol(version: string, symbol: string, data: ParsedSymbol): void;
+    getSearch(version: string, query: string): SearchResult | null;
+    setSearch(version: string, query: string, data: SearchResult): void;
+    getForumSearch(query: string): ForumSearchItem[] | null;
+    setForumSearch(query: string, results: ForumSearchItem[]): void;
+    private getEntry;
+    private setEntry;
+    private recordHitMiss;
+    private pruneIfNeeded;
+    getStats(): CacheStats;
+    clear(): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/cache/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAItF,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,WAAW,CAAoD;IACvE,OAAO,CAAC,WAAW,CAAoD;IACvE,OAAO,CAAC,UAAU,CAAyD;gBAE/D,MAAM,EAAE,MAAM;IAM1B,WAAW,IAAI,UAAU,EAAE,GAAG,IAAI;IAWlC,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IASzC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI/D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAKpE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI9D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAKnE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,IAAI;IAIvD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IAK/D,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;IAYrB,QAAQ,IAAI,UAAU;IAUtB,KAAK,IAAI,IAAI;CAOhB"}

package/dist/cache/manager.js

@@ -0,0 +1,123 @@
+import { getLogger } from '../utils/logger.js';
+import { metrics } from '../utils/metrics.js';
+export class CacheManager {
+    config;
+    logger = getLogger();
+    versionTtlMs;
+    versions = null;
+    fileCache = new Map();
+    symbolCache = new Map();
+    searchCache = new Map();
+    forumCache = new Map();
+    constructor(config) {
+        this.config = config;
+        this.versionTtlMs = config.versionCacheTtlMinutes * 60 * 1000;
+    }
+    // Versions
+    getVersions() {
+        if (!this.versions || Date.now() > this.versions.expiresAt) {
+            this.versions = null;
+            this.recordHitMiss(false);
+            return null;
+        }
+        this.versions.lastAccessed = Date.now();
+        this.recordHitMiss(true);
+        return this.versions.data;
+    }
+    setVersions(versions) {
+        this.versions = {
+            data: versions,
+            expiresAt: Date.now() + this.versionTtlMs,
+            lastAccessed: Date.now(),
+        };
+    }
+    // Files
+    getFile(version, path) {
+        return this.getEntry(this.fileCache, `file:${version}:${path}`);
+    }
+    setFile(version, path, content) {
+        this.setEntry(this.fileCache, `file:${version}:${path}`, content, this.config.fileCacheTtlMinutes);
+    }
+    // Symbols
+    getSymbol(version, symbol) {
+        return this.getEntry(this.symbolCache, `symbol:${version}:${symbol}`);
+    }
+    setSymbol(version, symbol, data) {
+        this.setEntry(this.symbolCache, `symbol:${version}:${symbol}`, data, this.config.symbolCacheTtlMinutes);
+    }
+    // Search
+    getSearch(version, query) {
+        return this.getEntry(this.searchCache, `search:${version}:${query}`);
+    }
+    setSearch(version, query, data) {
+        this.setEntry(this.searchCache, `search:${version}:${query}`, data, this.config.fileCacheTtlMinutes);
+    }
+    // Forum
+    getForumSearch(query) {
+        return this.getEntry(this.forumCache, `forum:${query}`);
+    }
+    setForumSearch(query, results) {
+        this.setEntry(this.forumCache, `forum:${query}`, results, 30);
+    }
+    // Generic helpers
+    getEntry(cache, key) {
+        const entry = cache.get(key);
+        if (!entry) {
+            this.recordHitMiss(false);
+            return null;
+        }
+        if (Date.now() > entry.expiresAt) {
+            cache.delete(key);
+            this.recordHitMiss(false);
+            return null;
+        }
+        entry.lastAccessed = Date.now();
+        this.recordHitMiss(true);
+        return entry.data;
+    }
+    setEntry(cache, key, data, ttlMinutes) {
+        cache.set(key, {
+            data,
+            expiresAt: Date.now() + ttlMinutes * 60 * 1000,
+            lastAccessed: Date.now(),
+        });
+        this.pruneIfNeeded();
+    }
+    recordHitMiss(hit) {
+        if (hit) {
+            metrics.recordCacheHit();
+        }
+        else {
+            metrics.recordCacheMiss();
+        }
+    }
+    pruneIfNeeded() {
+        const total = this.fileCache.size + this.symbolCache.size + this.searchCache.size + this.forumCache.size;
+        if (total > this.config.maxCacheEntries) {
+            this.logger.debug('Pruning cache', { totalEntries: total });
+            [this.fileCache, this.symbolCache, this.searchCache, this.forumCache].forEach(cache => {
+                for (const [key, entry] of cache.entries()) {
+                    if (Date.now() > entry.expiresAt)
+                        cache.delete(key);
+                }
+            });
+        }
+    }
+    getStats() {
+        const m = metrics.getMetrics();
+        return {
+            entries: this.fileCache.size + this.symbolCache.size + this.searchCache.size + this.forumCache.size,
+            hits: m.cache.hits,
+            misses: m.cache.misses,
+            hitRate: m.cache.hitRate,
+        };
+    }
+    clear() {
+        this.versions = null;
+        this.fileCache.clear();
+        this.symbolCache.clear();
+        this.searchCache.clear();
+        this.forumCache.clear();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/cache/manager.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+/**
+ * MNE Package metadata for multi-package support.
+ * Each package has its own GitHub repo, source path, and documentation URL.
+ */
+export interface MnePackageInfo {
+    repo: string;
+    sourcePath: string;
+    docsUrl: string;
+}
+/**
+ * Registry of supported MNE ecosystem packages.
+ */
+export declare const MNE_PACKAGES: Record<string, MnePackageInfo>;
+export declare const MNE_PACKAGE_NAMES: string[];
+export declare const DEFAULT_PACKAGE = "mne-python";
+/**
+ * Get package info by name, with fallback to default.
+ */
+export declare function getPackageInfo(packageName?: string): MnePackageInfo;
+export declare const ConfigSchema: z.ZodObject<{
+    port: z.ZodDefault<z.ZodNumber>;
+    transport: z.ZodDefault<z.ZodEnum<["http", "stdio"]>>;
+    githubToken: z.ZodString;
+    githubApiBase: z.ZodDefault<z.ZodString>;
+    defaultPackage: z.ZodDefault<z.ZodString>;
+    githubTimeout: z.ZodDefault<z.ZodNumber>;
+    forumBaseUrl: z.ZodDefault<z.ZodString>;
+    forumTimeout: z.ZodDefault<z.ZodNumber>;
+    versionCacheTtlMinutes: z.ZodDefault<z.ZodNumber>;
+    symbolCacheTtlMinutes: z.ZodDefault<z.ZodNumber>;
+    fileCacheTtlMinutes: z.ZodDefault<z.ZodNumber>;
+    maxCacheEntries: z.ZodDefault<z.ZodNumber>;
+    pythonPath: z.ZodDefault<z.ZodString>;
+    parserTimeout: z.ZodDefault<z.ZodNumber>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    logJson: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    port: number;
+    transport: "http" | "stdio";
+    githubToken: string;
+    githubApiBase: string;
+    defaultPackage: string;
+    githubTimeout: number;
+    forumBaseUrl: string;
+    forumTimeout: number;
+    versionCacheTtlMinutes: number;
+    symbolCacheTtlMinutes: number;
+    fileCacheTtlMinutes: number;
+    maxCacheEntries: number;
+    pythonPath: string;
+    parserTimeout: number;
+    logLevel: "debug" | "info" | "warn" | "error";
+    logJson: boolean;
+}, {
+    githubToken: string;
+    port?: number | undefined;
+    transport?: "http" | "stdio" | undefined;
+    githubApiBase?: string | undefined;
+    defaultPackage?: string | undefined;
+    githubTimeout?: number | undefined;
+    forumBaseUrl?: string | undefined;
+    forumTimeout?: number | undefined;
+    versionCacheTtlMinutes?: number | undefined;
+    symbolCacheTtlMinutes?: number | undefined;
+    fileCacheTtlMinutes?: number | undefined;
+    maxCacheEntries?: number | undefined;
+    pythonPath?: string | undefined;
+    parserTimeout?: number | undefined;
+    logLevel?: "debug" | "info" | "warn" | "error" | undefined;
+    logJson?: boolean | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAmDvD,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAA4B,CAAC;AAC3D,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,CAOnE;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,wBAAgB,UAAU,IAAI,MAAM,CAkCnC"}

package/dist/config.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+/**
+ * Registry of supported MNE ecosystem packages.
+ */
+export const MNE_PACKAGES = {
+    'mne-python': {
+        repo: 'mne-tools/mne-python',
+        sourcePath: 'mne/',
+        docsUrl: 'https://mne.tools/stable/',
+    },
+    'mne-bids-pipeline': {
+        repo: 'mne-tools/mne-bids-pipeline',
+        sourcePath: 'mne_bids_pipeline/',
+        docsUrl: 'https://mne.tools/mne-bids-pipeline/stable/',
+    },
+    'mne-bids': {
+        repo: 'mne-tools/mne-bids',
+        sourcePath: 'mne_bids/',
+        docsUrl: 'https://mne.tools/mne-bids/stable/',
+    },
+    'mne-connectivity': {
+        repo: 'mne-tools/mne-connectivity',
+        sourcePath: 'mne_connectivity/',
+        docsUrl: 'https://mne.tools/mne-connectivity/stable/',
+    },
+    'mne-nirs': {
+        repo: 'mne-tools/mne-nirs',
+        sourcePath: 'mne_nirs/',
+        docsUrl: 'https://mne.tools/mne-nirs/stable/',
+    },
+    'mne-rsa': {
+        repo: 'mne-tools/mne-rsa',
+        sourcePath: 'mne_rsa/',
+        docsUrl: 'https://mne.tools/mne-rsa/stable/',
+    },
+    'mne-icalabel': {
+        repo: 'mne-tools/mne-icalabel',
+        sourcePath: 'mne_icalabel/',
+        docsUrl: 'https://mne.tools/mne-icalabel/stable/',
+    },
+    'mne-realtime': {
+        repo: 'mne-tools/mne-realtime',
+        sourcePath: 'mne_realtime/',
+        docsUrl: 'https://mne.tools/mne-realtime/',
+    },
+    'mne-lsl': {
+        repo: 'mne-tools/mne-lsl',
+        sourcePath: 'mne_lsl/',
+        docsUrl: 'https://mne.tools/mne-lsl/stable/',
+    },
+    'mne-gui-addons': {
+        repo: 'mne-tools/mne-gui-addons',
+        sourcePath: 'mne_gui_addons/',
+        docsUrl: 'https://mne.tools/mne-gui-addons/',
+    },
+};
+export const MNE_PACKAGE_NAMES = Object.keys(MNE_PACKAGES);
+export const DEFAULT_PACKAGE = 'mne-python';
+/**
+ * Get package info by name, with fallback to default.
+ */
+export function getPackageInfo(packageName) {
+    const name = packageName || DEFAULT_PACKAGE;
+    const info = MNE_PACKAGES[name];
+    if (!info) {
+        throw new Error(`Unknown MNE package: ${name}. Supported: ${MNE_PACKAGE_NAMES.join(', ')}`);
+    }
+    return info;
+}
+export const ConfigSchema = z.object({
+    port: z.coerce.number().default(8000),
+    transport: z.enum(['http', 'stdio']).default('http'),
+    githubToken: z.string().min(1),
+    githubApiBase: z.string().default('https://api.github.com'),
+    defaultPackage: z.string().default(DEFAULT_PACKAGE),
+    githubTimeout: z.coerce.number().default(15000),
+    forumBaseUrl: z.string().default('https://mne.discourse.group'),
+    forumTimeout: z.coerce.number().default(15000),
+    versionCacheTtlMinutes: z.coerce.number().default(60),
+    symbolCacheTtlMinutes: z.coerce.number().default(30),
+    fileCacheTtlMinutes: z.coerce.number().default(15),
+    maxCacheEntries: z.coerce.number().default(1000),
+    pythonPath: z.string().default('python3'),
+    parserTimeout: z.coerce.number().default(10000),
+    logLevel: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+    logJson: z.coerce.boolean().default(false),
+});
+export function loadConfig() {
+    const config = {
+        port: process.env.MNE_PORT,
+        transport: process.env.MNE_TRANSPORT,
+        githubToken: process.env.MNE_GITHUB_TOKEN,
+        githubApiBase: process.env.MNE_GITHUB_API_BASE,
+        defaultPackage: process.env.MNE_DEFAULT_PACKAGE,
+        githubTimeout: process.env.MNE_GITHUB_TIMEOUT,
+        forumBaseUrl: process.env.MNE_FORUM_BASE_URL,
+        forumTimeout: process.env.MNE_FORUM_TIMEOUT,
+        versionCacheTtlMinutes: process.env.MNE_CACHE_TTL_MINUTES, // Using generic TTL for version if not specific
+        symbolCacheTtlMinutes: process.env.MNE_SYMBOL_CACHE_TTL_MINUTES,
+        fileCacheTtlMinutes: process.env.MNE_FILE_CACHE_TTL_MINUTES,
+        maxCacheEntries: process.env.MNE_MAX_CACHE_ENTRIES,
+        pythonPath: process.env.MNE_PYTHON_PATH,
+        parserTimeout: process.env.MNE_PARSER_TIMEOUT,
+        logLevel: process.env.MNE_LOG_LEVEL,
+        logJson: process.env.MNE_LOG_JSON,
+    };
+    // Filter undefined values to allow Zod defaults to work
+    const cleanConfig = Object.fromEntries(Object.entries(config).filter(([_, v]) => v !== undefined));
+    try {
+        return ConfigSchema.parse(cleanConfig);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const issues = error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join('\n');
+            throw new Error(`Configuration validation failed:\n${issues}\n\nMake sure MNE_GITHUB_TOKEN is set.`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/forum/client.d.ts

@@ -0,0 +1,9 @@
+import { ForumSearchItem } from '../types.js';
+export declare class ForumClient {
+    readonly baseUrl: string;
+    readonly timeout: number;
+    private logger;
+    constructor(baseUrl: string, timeout: number);
+    search(query: string, limit?: number): Promise<ForumSearchItem[]>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/forum/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgE9C,qBAAa,WAAW;IACpB,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAKtC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CA0C7E"}

package/dist/forum/client.js

@@ -0,0 +1,48 @@
+import { getLogger } from '../utils/logger.js';
+export class ForumClient {
+    baseUrl;
+    timeout;
+    logger = getLogger();
+    constructor(baseUrl, timeout) {
+        this.baseUrl = baseUrl;
+        this.timeout = timeout;
+    }
+    async search(query, limit = 5) {
+        const url = `${this.baseUrl}/search.json?q=${encodeURIComponent(query)}`;
+        try {
+            const response = await fetch(url, {
+                headers: { 'Accept': 'application/json' },
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok) {
+                this.logger.error('Forum search failed', { status: response.status });
+                return [];
+            }
+            const data = await response.json();
+            // Discourse returns topics and posts separately
+            // Posts contain the blurb/excerpt, topics contain metadata
+            const topics = data.topics || [];
+            const posts = data.posts || [];
+            // Create a map of topic_id -> first post blurb
+            const postBlurbs = new Map();
+            for (const post of posts) {
+                if (post.topic_id && post.blurb && !postBlurbs.has(post.topic_id)) {
+                    postBlurbs.set(post.topic_id, post.blurb);
+                }
+            }
+            return topics.slice(0, limit).map((t) => ({
+                source: 'forum',
+                title: t.fancy_title || t.title,
+                url: `${this.baseUrl}/t/${t.slug}/${t.id}`,
+                blurb: postBlurbs.get(t.id) || t.excerpt || t.blurb || '',
+                postsCount: t.posts_count,
+                createdAt: t.created_at,
+            }));
+        }
+        catch (error) {
+            this.logger.error('Forum search error', { error });
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/forum/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/forum/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA+D/C,MAAM,OAAO,WAAW;IACJ,OAAO,CAAS;IAChB,OAAO,CAAS;IACxB,MAAM,GAAG,SAAS,EAAE,CAAC;IAE7B,YAAY,OAAe,EAAE,OAAe;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,QAAgB,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAEzE,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC9B,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;gBACzC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aAC5C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtE,OAAO,EAAE,CAAC;YACd,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAC;YAE9D,gDAAgD;YAChD,2DAA2D;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAE/B,+CAA+C;YAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAChE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC9C,CAAC;YACL,CAAC;YAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,MAAM,EAAE,OAAgB;gBACxB,KAAK,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK;gBAC/B,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,EAAE;gBAC1C,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE;gBACzD,UAAU,EAAE,CAAC,CAAC,WAAW;gBACzB,SAAS,EAAE,CAAC,CAAC,UAAU;aAC1B,CAAC,CAAC,CAAC;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;CACJ"}

package/dist/github/client.d.ts

@@ -0,0 +1,33 @@
+import { Config } from '../config.js';
+import { MneVersion, GithubIssueItem } from '../types.js';
+import { GitHubSearchCodeResult, GitHubIssueDetail, GitHubIssueComment, RateLimitInfo } from './types.js';
+export declare class GitHubClient {
+    readonly config: Config;
+    private logger;
+    private rateLimitInfo;
+    constructor(config: Config);
+    private getRepo;
+    getRateLimitInfo(): RateLimitInfo | null;
+    private updateRateLimit;
+    private handleRateLimit;
+    private request;
+    fetchVersions(limit?: number, packageName?: string): Promise<MneVersion[]>;
+    getLatestVersion(packageName?: string): Promise<string>;
+    fetchFile(path: string, version?: string, packageName?: string): Promise<string | null>;
+    fileExists(path: string, version?: string, packageName?: string): Promise<boolean>;
+    searchCode(query: string, options?: {
+        path?: string;
+        perPage?: number;
+        version?: string;
+        packageName?: string;
+    }): Promise<GitHubSearchCodeResult>;
+    searchIssues(query: string, options?: {
+        state?: 'open' | 'closed' | 'all';
+        labels?: string[];
+        perPage?: number;
+        packageName?: string;
+    }): Promise<GithubIssueItem[]>;
+    getIssue(issueNumber: number, packageName?: string): Promise<GitHubIssueDetail | null>;
+    getIssueComments(issueNumber: number, packageName?: string): Promise<GitHubIssueComment[]>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkB,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACgB,sBAAsB,EACpB,iBAAiB,EACtC,kBAAkB,EAAa,aAAa,EAC/C,MAAM,YAAY,CAAC;AAIpB,qBAAa,YAAY;IACrB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAA8B;gBAEvC,MAAM,EAAE,MAAM;IAI1B,OAAO,CAAC,OAAO;IAIf,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC,OAAO,CAAC,eAAe;YAkBT,eAAe;YAaf,OAAO;IAoCf,aAAa,CAAC,KAAK,GAAE,MAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAU9E,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyBvF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlF,UAAU,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAC1F,OAAO,CAAC,sBAAsB,CAAC;IAS5B,YAAY,CACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/G,OAAO,CAAC,eAAe,EAAE,CAAC;IA2BvB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAyBtF,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAkBnG"}