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许可证- 许可证 来修改标记元素的显示属性。

🔗 相关链接

• MCP仕様
• FastMCP

🤝 支持

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

______________________________________________________________________

Adaptus -更好的代码质量🔧