MCP 源码关系服务器

这是一个 MCP 服务器，用于分析指定目录下 src 文件夹中源代码之间的关系。 它解析各种编程语言的导入语句，并确定文件之间的依赖关系。 通过集成到 Claude 中，Claude 可以快速检查项目的依赖关系，并帮助识别相关文件。

<a href="https://glama.ai/mcp/servers/jmnzj9317i"><img width="380" height="200" src="https://glama.ai/mcp/servers/jmnzj9317i/badge" alt="Source Relation Server MCP server" /></a>

功能

• 支持多种语言的导入解析
  • 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

安装

# 安装 uv
$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ cd /path/to/mcp-source-relation
# 安装依赖库
$ uv sync

Claude for Desktop 中的配置

将以下配置添加到 claude_desktop_config.json：

{
    "mcpServers": {
        "source-relation": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-source-relation",  // 请替换为该项目目录的绝对路径
                "run",
                "source_relation.py"
            ]
        }
    }
}

使用方法

在 Claude 中使用

可以通过指示 Claude 执行类似 /Users/xxx/GitHub/xxx/ 的源代码依赖关系检查 的操作来使用。

让我们检查一下 `/Users/owa/GitHub/mcp-source-relation/` 的源代码依赖关系。

从依赖关系分析结果中，可以确认以下结构：

1. 主要分析模块: `src/source_analyzer.py`
   - 使用特定于每种语言的分析模块（Ruby、Python、TypeScript、Rust）

2. 语言特定的分析模块:
   - `src/analyzers/ruby.py`
   - `src/analyzers/python.py`
   - `src/analyzers/typescript.py`
   - `src/analyzers/rust.py`
   - 全部继承自 `src/analyzers/base.py`

3. 共同基础:
   - `src/analyzers/base.py`: 提供基本分析功能
   - `src/utils/path.py`: 路径操作实用程序
   - `src/configs/typescript.py`: TypeScript 特定的配置

特点：
- 每种语言的分析模块都继承自一个公共基类（base.py），从而实现了一致的设计
- 只有 TypeScript 有自己的配置文件（configs/typescript.py）
- 路径操作被聚合到一个公共实用程序模块（utils/path.py）中

从这个结构可以看出，如果要添加对新语言的支持，可以通过在 `src/analyzers/` 中添加一个新模块并继承 `base.py` 来实现。

如果指定目录，则分析该目录下的 src 目录。 如果指定文件，则以该文件为基准进行分析。 支持从 prompt 输入路径。 如果在 prompt 中使用，请选择 Attach from MCP -> Choose an integration -> source-relation。

输出格式

分析结果以以下 JSON 格式输出：

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

所有路径都显示为相对于 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;