AI导哈

代码质量分析工具

Adaptus MCP Server是一个用于Python代码质量分析和设计改进建议的MCP服务器，结合静态分析和AI技术，提供高效的代码质量改进方案。

  • by shimizumasaru
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 shimizumasaru/adaptus-mcp-server

使用说明

Adaptus MCP服务器

代码质量分析和设计改进MCP（Model Context Protocol）服务器

📋 概要

Adaptus单击功能区上Python分析代码的技术负债，提供设计改进建议MCP服务器。静态分析和AI中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

🚀 主要功能

🔍 代码分析（analyze_debt)

  • Python提取代码的基本度量
  • 计算负债分数（SQLE/SIG兼容计算公式）
  • 支持多个文件的批量分析

📐 设计提案（propose_design)

  • 把类图的雏形Mermaid格式生成
  • 建议设计改进的具体计划
  • 提出彻底的兴趣分离的体系结构方案

✅ 修补程序验证（verify_patch)

  • 执行外部构建命令
  • 自动运行测试套件
  • CI/CD与管线协作

📊 分数公式资源

  • 计算负债分数JSON形式提供
  • 参照加权设置
  • 建议定期校准

🛠️ 安装

前提条件

  • Python 3.10以上
  • uv（建议）或pip

安装说明

# uvを使用する場合（推奨）
curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/shimizumasaru/adaptus-mcp-server.git
cd adaptus-mcp-server
uv sync

# pipを使用する場合
git clone https://github.com/shimizumasaru/adaptus-mcp-server.git
cd adaptus-mcp-server
pip install -e .

🚀 用法

MCP启动服务器

# uvを使用
uv run adaptus-server

# pipを使用
adaptus-server

MCP与客户端协作

Cursor在…的情况下

  1. 打开设置画面（⌘，）
  2. MCP在节中添加服务器
  3. 网址： http://localhost:8000

Claude Code在…的情况下

claude mcp add --transport http --name adaptus http://localhost:8000

工具示例

# コード分析
from adaptus import analyze_debt
result = analyze_debt(["src/main.py"])

# 設計提案
from adaptus import propose_design
proposal = propose_design("リファクタリングが必要")

# パッチ検証
from adaptus import verify_patch
verification = verify_patch("python -m build", "pytest")

🧪 开発

开发环境设置

# 開発依存関係のインストール
uv sync --dev

# テストの実行
uv run pytest tests/ -v

# コード品質チェック
uv run ruff check .
uv run black .
uv run mypy src/

测试

# すべてのテストを実行
uv run pytest

# カバレッジを含めて実行
uv run pytest --cov=adaptus

编码质量

  • 颈毛：选择和格式检查
  • 黑色：代码形成器
  • 米皮：静态类型检查

📊 负债分数公式

Adaptus那么按以下加权计算负债分数：

{
  "weights": {
    "mi": 0.35,    // 保守性
    "cc": 0.25,    // 複雑度
    "dup": 0.20,   // 重複率
    "td": 0.20     // テストカバレッジ
  }
}

分数介于0.0和10.0之间，数值越高表示负债越大。

🔄 CI/CD

GitHub 操作

  • 持续集成：自动测试和代码质量检查
  • 定期扫描：工作日定期代码分析

工作流程

# .github/workflows/ci.yml
- テスト実行
- コード品質チェック
- ビルドとパッケージ化

# .github/workflows/adaptus-scan.yml
- 定期的な負債分析
- レポート生成
- アーティファクト保存

📝 貢献

  1. Fork做
  2. 创建功能分支（git checkout -b feature/amazing-feature)
  3. 提交更改（git commit -m 'Add amazing feature')
  4. 推到分支（git push origin feature/amazing-feature)
  5. Pull Request创建

📄 许可证

MIT许可证- 许可证 来修改标记元素的显示属性。

🔗 相关链接

🤝 支持

关于错误报告和功能要求GitHub Issues来定义自定义外观。

Adaptus -更好的代码质量🔧

相关 MCP