Source Relation

🚀 MCP Source Relation Server

An MCP server that parses the relevance of source code in the src sub - directory under the specified directory. It analyzes the import statements of each language and determines the dependencies between files. After integrating it into Claude, Claude can quickly confirm the project's dependencies and help identify relevant files.

✨ Features

• Support for parsing import statements in multiple languages:
  • TypeScript/JavaScript: import statements, require statements
  • Python: import statements, from ... import statements
  • Ruby: require statements, require_relative statements
  • Rust: mod declarations, use statements
• Support for path aliases in tsconfig.json (e.g., @/components/...).
• Support for special features of each language:
  • Python: __init__.py, relative imports
  • Rust: mod.rs pattern
  • TypeScript: aliases, index.ts
  • Ruby: require without file extensions

📦 Installation

Prerequisites

• Python 3.10 or higher
• uv tool

Installation Steps

# Install the uv tool
$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ cd /path/to/mcp-source-relation
# Install dependent libraries
$ uv sync

Configuration in Claude Desktop

Add the following content to the claude_desktop_config.json file:

{
  "dependencies": {
    "components/Button.tsx": [
      "types/index.ts",
      "utils/theme.ts"
    ],
    "pages/index.tsx": [
      "components/Button.tsx",
      "utils/api.ts"
    ]
  }
}

💻 Usage Examples

All paths are represented as relative paths based on the src directory.

Supported Import Formats

TypeScript/JavaScript

• import { Component } from './Component'
• import type { Type } from '@/types'
• import './styles.css'
• require('./module')
• Alias paths (e.g., @/components/...)

Python

• import module
• from module import name
• from .module import name
• from ..module import name

Ruby

• require 'module'
• require_relative './module'
• Require without file extensions

Rust

• mod module;
• use crate::module;
• use super::module;
• use self::module;