SEP MCP

歧管发动机MCP服务器

一个模型上下文协议服务器，为AI编码助手提供高速、结构化的代码库分析和动态上下文管理。它不是逐个读取代码令牌，而是映射存储库 *结构上* --将源文件视为连续的字节流，计算结构签名，并在O（1）时间内检测架构混乱。

当前状态：所有阶段0的关键错误都已解决，包括FAISS语义搜索反序列化， ingest_repo 相对路径解析、组合风险公式透明度和不同的集群命名启发式。所有21个分析工具功能齐全。

______________________________________________________________________

核心能力

______________________________________________________________________

安装

先决条件

• Python 3.10+
• Valkey（或Redis）正在运行 localhost:6379
• C++20编译器（用于构建本机结构引擎）
• faiss-cpu （运行 cluster_codebase_structure 工具）

设置

# 1. Start the Valkey backend
valkey-server

# 2. Install the manifold engine
pip install -e .

# 3. Configure your MCP client (Kilo Code, Claude Desktop, Cursor, etc.)

添加到MCP客户端配置中：

{
  "mcpServers": {
    "manifold": {
      "command": "path/to/virtualenv/bin/python",
      "args": ["path/to/SEP-mcp/mcp_server.py"],
      "cwd": "path/to/SEP-mcp"
    }
  }
}

______________________________________________________________________

常见工作流和用例

1.新存储库分析

在输入新代码库时，执行初始映射以立即了解技术债务分布。

# 1. Index the repository
ingest_repo  (root_dir=".", clear_first=true, compute_chaos=true)

# 2. Verify ingestion was successful
get_index_stats

# 3. Quickly identify the most complex, chaotic files
batch_chaos_scan  (pattern="*.py", max_files=30)

2.重构决策和Sprint计划

使用结构风险度量来客观地决定重写什么代码。

# 1. Scan for files with BOTH high complexity and high import dependencies
scan_critical_files       (pattern="*.py", max_files=10)

# 2. For candidates, predict how soon the file will become unmaintainable
predict_structural_ejection (path="target.py", horizon_days=30)

# 3. For visual confirmation, generate a 4-panel chaos dashboard
visualize_manifold_trajectory (path="target.py")

3.寻找实施模式

与其按文本搜索，不如按结构签名搜索，以找到类似的逻辑块或克隆。

# 1. Get the mathematical signature of an existing file
get_file_signature  (path="found_file.py")

# 2. Search for any other files that match this structure globally
search_by_structure (signature="c0.213_s0.000_e0.928", tolerance=0.05)

4.连续流动

# Run the watcher inside the repo
start_watcher  (watch_dir=".")

# The engine now automatically syncs and re-evaluates risk natively whenever files are saved.

______________________________________________________________________

工具参考（20个工具）

所有工具都记录了参数、示例和工作流程 MCP_TOOL_GUIDE.md.

索引和监控

文件发现和搜索

混沌分析

依赖性和组合风险

验证和记忆

______________________________________________________________________

实证验证

React 15.0案例研究

结构引擎标记了确切的文件(ReactReconcileTransaction.js, ReactInstanceHandles.js)React核心团队随后删除并重写为React Fiber——对JavaScript没有任何语义理解。 → 阅读研究

Langchain ROC分析

盲前向预测研究 langchain v0.0.300 证明了混沌分数阈值 0.396 最佳地预测架构弹出，在O（1）速度下达到昂贵AST解析工具预测能力的91%左右。 → 阅读研究

内存优化

Zstandard压缩将cpython索引从 3.4 GB到28 MB （减少>99%），检索精度零损失。

______________________________________________________________________

文档

______________________________________________________________________

许可证

麻省理工学院——见 许可证