Metadata-Version: 2.4
Name: surecode
Version: 0.1.0
Summary: SureCode — 代码分析数据库。扫描、分析、入库。和 SureGuard 配合使用效果更佳。
Project-URL: Homepage, https://github.com/benbird316/SureCode
Project-URL: Repository, https://github.com/benbird316/SureCode
Project-URL: Issues, https://github.com/benbird316/SureCode/issues
Author: benbird316
License-Expression: Apache-2.0
Keywords: code-analysis,code-quality,mcp,static-analysis,sure
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# SureCode

SureCode 是一个代码分析数据库 MCP 服务器。它扫描你的代码，提取结构信息和分析结果，存入本地 SQLite 数据库。

## 定位

```
Code Scalpel:     提取 + 分析（手术刀，不存）
codebase-memory:  结构 + 索引（快，但只存结构信息）

surecode:         分析 + 入库（做深度分析，结果持久化，和 SureGuard 联动）
```

## 安装

```bash
pip install surecode
```

## 使用

在 MCP 客户端（Cursor、Claude Desktop 等）中配置：

```json
{
  "mcpServers": {
    "surecode": {
      "command": "python",
      "args": ["-m", "surecode.server"],
      "env": {
        "SURE_Vault_PATH": "./.surecode"
      }
    }
  }
}
```

## MCP 工具

### scanner 模块 — 代码扫描分析

| 工具 | 描述 |
|------|------|
| `scan_project` | 扫描整个项目，提取符号和依赖 |
| `scan_file` | 扫描单个文件 |
| `get_symbols` | 获取项目符号表 |
| `get_quality_issues` | 获取代码质量问题 |
| `get_dependencies` | 获取项目依赖图 |
| `get_function_detail` | 获取函数详情 |

### vault 模块 — 分析结果持久化

| 工具 | 描述 |
|------|------|
| `search_symbols` | FTS5 全文搜索符号 |
| `compare_snapshots` | 两个时间点的代码对比 |
| `get_project_summary` | 项目分析概览 |
| `clear_vault` | 清空 vault |

## 与 SureGuard 配合

- **扫描入库**：surecode 分析 → 存入 vault
- **门控调用**：sureguard 从 vault 读取基线，判断代码变更是否安全

```bash
pip install sureguard surecode
```
