MCP Source Relation Server

指定されたディレクトリの src 配下のソースコードの関連性を解析するMCPサーバーです。 言語ごとのインポート文を解析し、ファイル間の依存関係を特定します。 Claudeに組み込むことで、Claudeがプロジェクトの依存関係を素早く確認でき、関連するファイルの特定に役立ちます。

機能

• 複数言語のインポート解析をサポート

  • TypeScript/JavaScript: import文、require文

  • Python: import文、from ... import文

  • Ruby: require文、require_relative文

  • Rust: mod宣言、use文

• tsconfig.jsonのパスエイリアス（@/components/...など）に対応

• 言語ごとの特殊な機能に対応

  • Python: __init__.py、相対インポート

  • Rust: mod.rsパターン

  • TypeScript: エイリアス、index.ts

  • Ruby: 拡張子なしのrequire

セットアップ

必要条件

• Python 3.10以上

• uv

インストール

Claude for Desktopでの設定

claude_desktop_config.json に以下の設定を追加してください：

使用方法

Claudeでの使用

/Users/xxx/GitHub/xxx/ のソースの依存関係を確認して のように指示すると動作します

ディレクトリを指定した場合はその下の src ディレクトリを解析します ファイルを指定した場合はそのファイルを基準に解析します promptからのパス入力にも対応しています promptで利用する場合は、Attach from MCP->Choose an integration->source-relationを選択してください

出力形式

解析結果は以下のようなJSON形式で出力されます：

すべてのパスはsrcディレクトリを基準とした相対パスで表示されます。

サポートされるインポート形式

TypeScript/JavaScript

• import { Component } from './Component'

• import type { Type } from '@/types'

• import './styles.css'

• require('./module')

• エイリアスパス（@/components/...）

Python

• import module

• from module import name

• from .module import name

• from ..module import name

Ruby

• require 'module'

• require_relative './module'

• 拡張子なしのrequire

Rust

• mod module;

• use crate::module;

• use super::module;

• use self::module;