analyze_backlinks
Analyze backlinks and understand graph structure for a specific note in Obsidian vaults to visualize connections and relationships.
Instructions
バックリンク分析とグラフ構造の把握を行います
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| targetNote | Yes | 分析対象のノートパス（vault相対パス） |
Implementation Reference
- src/obsidian-handler.ts:493-598 (handler)Core handler function that implements the analyze_backlinks tool logic: scans all vault .md files for incoming wiki links [[target]] and markdown links to the target note, extracts context snippets, identifies related notes, and computes basic graph metrics.async analyzeBacklinks(targetNote: string): Promise<{ targetNote: string; backlinks: Array<{ sourceFile: string; context: string; linkType: 'wiki' | 'markdown'; }>; relatedNotes: string[]; metrics: { popularity: number; centrality: number; }; }> { if (!FileUtils.validatePath(this.config.vaultPath, targetNote)) { throw new Error('無効なターゲットノートパスです'); } const targetFullPath = path.join(this.config.vaultPath, targetNote); if (!(await FileUtils.fileExists(targetFullPath))) { throw new Error(`ターゲットノート '${targetNote}' が見つかりません`); } const vaultPath = this.config.vaultPath; const backlinks: Array<{ sourceFile: string; context: string; linkType: 'wiki' | 'markdown'; }> = []; // ターゲットノートのベース名（拡張子なし） const targetBaseName = path.basename(targetNote, '.md'); // すべてのMarkdownファイルを取得 const allMdFiles = await this.getAllMdFiles(vaultPath); const processFile = async (filePath: string) => { try { const content = await fs.readFile(filePath, 'utf-8'); const lines = content.split('\n'); const relativeFilePath = path.relative(vaultPath, filePath); // ターゲットノート自体はスキップ if (path.resolve(filePath) === path.resolve(targetFullPath)) { return; } for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) { const line = lines[lineIndex]; // ウィキリンク [[]] の検出 const wikiLinkMatches = line.matchAll(/\[\[([^\]|]+)(\|[^\]]+)?\]\]/g); for (const match of wikiLinkMatches) { const linkTarget = match[1]; if (linkTarget === targetBaseName || linkTarget === targetNote || linkTarget === targetNote.replace(/\.md$/, '')) { const context = this.extractContext(lines, lineIndex); backlinks.push({ sourceFile: relativeFilePath, context, linkType: 'wiki', }); } } // Markdownリンク []() の検出 const mdLinkMatches = line.matchAll(/\[([^\]]+)\]\(([^)]+)\)/g); for (const match of mdLinkMatches) { const linkTarget = match[2]; if (linkTarget.includes(targetBaseName) || linkTarget.includes(targetNote)) { const context = this.extractContext(lines, lineIndex); backlinks.push({ sourceFile: relativeFilePath, context, linkType: 'markdown', }); } } } } catch (error) { // ファイル読み込みエラーは無視 } }; // すべてのMarkdownファイルを処理 for (const filePath of allMdFiles) { await processFile(filePath); } // 関連ノートを計算（バックリンクを持つファイル） const relatedNotes = [...new Set(backlinks.map(bl => bl.sourceFile))]; // メトリクスを計算 const popularity = backlinks.length; const centrality = this.calculateCentrality(backlinks, allMdFiles.length); return { targetNote, backlinks, relatedNotes, metrics: { popularity, centrality, }, }; }
- src/server.ts:200-213 (registration)Registration of the 'analyze_backlinks' tool in the MCP server's tool list, including name, description, and input schema.{ name: 'analyze_backlinks', description: 'バックリンク分析とグラフ構造の把握を行います', inputSchema: { type: 'object', properties: { targetNote: { type: 'string', description: '分析対象のノートパス（vault相対パス）', }, }, required: ['targetNote'], }, },
- src/server.ts:352-363 (handler)MCP server request handler (switch case) that receives tool calls for 'analyze_backlinks', extracts arguments, delegates to ObsidianHandler.analyzeBacklinks, and formats response as JSON text content.case 'analyze_backlinks': const backlinksResult = await this.obsidianHandler.analyzeBacklinks( args.targetNote as string ); return { content: [ { type: 'text', text: JSON.stringify(backlinksResult, null, 2), }, ], };
- src/server.ts:203-212 (schema)Input schema definition for the analyze_backlinks tool, specifying required 'targetNote' parameter.inputSchema: { type: 'object', properties: { targetNote: { type: 'string', description: '分析対象のノートパス（vault相対パス）', }, }, required: ['targetNote'], },
- src/obsidian-handler.ts:424-447 (helper)Helper method used by analyzeBacklinks to recursively find all Markdown files in the Obsidian vault.private async getAllMdFiles(dirPath: string): Promise<string[]> { const files: string[] = []; const processDirectory = async (currentPath: string) => { try { const entries = await fs.readdir(currentPath, { withFileTypes: true }); for (const entry of entries) { const fullPath = path.join(currentPath, entry.name); if (entry.isDirectory()) { await processDirectory(fullPath); } else if (entry.isFile() && entry.name.endsWith('.md')) { files.push(fullPath); } } } catch (error) { // ディレクトリ読み込みエラーは無視 } }; await processDirectory(dirPath); return files; }