MCP Source Relation Server

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;