mne-docs-mcp 1.0.48 → 1.0.49

package/dist/utils/searchRanking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchRanking.d.ts","sourceRoot":"","sources":["../../src/utils/searchRanking.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjE,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,WAAW,CAoCd;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/utils/searchRanking.js

@@ -0,0 +1,63 @@
+export function rankSearchMatch(params) {
+    const tokens = tokenizeQuery(params.query);
+    const haystacks = [
+        params.title || '',
+        params.path || '',
+        params.snippet || '',
+        ...(params.tags || []),
+    ].map(toSearchText);
+    const matchedTerms = tokens.filter(token => haystacks.some(text => text.includes(token)));
+    const naturalLanguage = isHowToQuery(params.query);
+    let score = matchedTerms.length * 100;
+    const title = (params.title || '').toLowerCase();
+    const path = (params.path || '').toLowerCase();
+    const snippet = (params.snippet || '').toLowerCase();
+    const joinedQuery = params.query.toLowerCase().trim();
+    if (joinedQuery && title.includes(joinedQuery))
+        score += 120;
+    if (joinedQuery && path.includes(joinedQuery.replace(/\s+/g, '_')))
+        score += 100;
+    if (matchedTerms.length === tokens.length && tokens.length > 0)
+        score += 80;
+    if (snippet && matchedTerms.some(term => snippet.includes(term)))
+        score += 40;
+    if (params.kind === 'docs')
+        score += naturalLanguage ? 260 : 120;
+    if (params.kind === 'example')
+        score += naturalLanguage ? 320 : 180;
+    if (params.kind === 'code')
+        score += naturalLanguage ? 70 : 120;
+    if (params.kind === 'issue')
+        score += naturalLanguage ? 30 : 80;
+    if (params.kind === 'forum')
+        score += naturalLanguage ? 50 : 90;
+    if (path.includes('tutorial') || path.includes('auto_tutorial'))
+        score += 90;
+    if (path.includes('example') || path.includes('auto_example'))
+        score += 70;
+    const matchReason = matchedTerms.length > 0
+        ? `${params.kind} match on ${matchedTerms.join(', ')}`
+        : `${params.kind} fallback match`;
+    return { score, matchedTerms, matchReason };
+}
+export function tokenizeQuery(query) {
+    return Array.from(new Set((query.toLowerCase().match(/[a-z0-9_]+/g) || [])
+        .filter(token => token.length >= 3 && !STOP_WORDS.has(token))));
+}
+export function isHowToQuery(query) {
+    return /\b(how|why|when|where|tutorial|example|guide|steps?)\b/i.test(query);
+}
+const STOP_WORDS = new Set([
+    'and',
+    'for',
+    'from',
+    'into',
+    'that',
+    'the',
+    'use',
+    'with',
+]);
+function toSearchText(value) {
+    return typeof value === 'string' ? value.toLowerCase() : '';
+}
+//# sourceMappingURL=searchRanking.js.map

package/dist/utils/searchRanking.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mne-docs-mcp",
-  "version": "1.0.48",
+  "version": "1.0.49",
   "mcpName": "io.github.weiyongxu/mne-docs",
   "description": "MCP server providing access to MNE-Python documentation, source code, GitHub issues, and community forum",
   "type": "module",

package/python/ast_extractor.py

@@ -361,6 +361,9 @@ def extract_cross_references(source: str, symbol_name: str, module_name: str = "
         if parts[0] and parts[0][0].isupper():
             class_context = parts[0]
             method_name = parts[1] if len(parts) > 1 else None
+    elif symbol_name and symbol_name[0].isupper():
+        class_context = symbol_name
+        method_name = None
     
     # Find callees (what the symbol calls)
     callees = []