Contract Risk Review
Chinese labor & service contract risk assessment with 25 categories and local law differences.
Open source Open in the app JSON README (API)
About
Chinese labor & service contract risk assessment with 25 categories and local law differences.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- justingyang218
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Last push
- 2026-08-28T16:49:39Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 04:00:18
- Updated
- 2026-08-29 04:00:18
- Origin id
io.github.justingyang218/contract-risk-review-mcp
README
# 劳动&劳务合同风险排查 MCP Server
基于 FastMCP 构建的合同风险审查 MCP 服务，可被任何支持 MCP 协议的客户端（DeepSeek Harness、Claude Code、Cursor、Windsurf 等）调用。
## ✨ 功能特性
- **单份合同审查**：对劳动合同（16类风险）或劳务合同（9类风险）进行全面智能审查
- **批量合同审查**：支持多份合同批量审查，自动生成总览表
- **风险知识库查询**：查询指定类别的风险审查要点、法律依据
- **地方法规查询**：查询北京/上海/广东/浙江/江苏的地方法规差异
- **自动合同类型识别**：智能判断是劳动合同还是劳务合同
- **个人信息脱敏**：自动对身份证号、手机号、银行卡号进行脱敏处理
## 📦 安装
```bash
pip install -r requirements.txt
```
## ⚙️ 配置
### 环境变量
| 变量名 | 必填 | 默认值 | 说明 |
|--------|------|--------|------|
| `LLM_API_KEY` | ✅ 是 | - | 大模型 API 密钥 |
| `LLM_BASE_URL` | ❌ 否 | `https://api.openai.com/v1` | API 端点地址（OpenAI 兼容接口） |
| `LLM_MODEL` | ❌ 否 | `gpt-4o-mini` | 模型名称 |
| `LLM_TEMPERATURE` | ❌ 否 | `0.1` | 采样温度 |
### 配置示例
```bash
export LLM_API_KEY="sk-xxxxxxxxxxxxxx"
export LLM_BASE_URL="https://api.deepseek.com/v1"
export LLM_MODEL="deepseek-chat"
```
> 💡 支持任何 OpenAI 兼容的 API 接口（DeepSeek、通义千问、智谱 AI、Ollama 等）
## 🚀 运行
### 方式一：STDIO 模式（本地工具/桌面客户端）
```bash
python server.py
# 或显式指定
python server.py stdio
```
### 方式二：HTTP 模式（网络服务）
```bash
python server.py http 0.0.0.0 8000
```
启动后访问 `http://localhost:8000/mcp` 即可使用。
### 方式三：使用 fastmcp CLI
```bash
# 开发调试
fastmcp dev server.py
# 安装到 Claude Desktop
fastmcp install server.py
```
## 🔌 MCP Tools
### 1. `review_contract`
对合同文本进行完整的风险审查。
**参数：**
- `contract_text` (string, 必填)：合同文本内容
- `contract_type` (string, 可选)：合同类型，`auto`/`labor`/`service`，默认 `auto`
**示例：**
```
review_contract(contract_text="劳动合同文本...", contract_type="auto")
```
### 2. `batch_review`
批量审查多份合同。
**参数：**
- `contracts_text` (string, 必填)：多份合同文本
- `separator` (string, 可选)：分隔符，默认 `---合同分割线---`
**示例：**
```
batch_review(contracts_text="合同1\n---合同分割线---\n合同2", separator="---合同分割线---")
```
### 3. `get_risk_knowledge`
查询指定类别的风险知识库。
**参数：**
- `category` (string, 必填)：风险类别，如"试用期"、"竞业限制"、"人身损害赔偿"
**示例：**
```
get_risk_knowledge(category="竞业限制")
```
### 4. `get_local_regulations`
查询指定地区的法规差异。
**参数：**
- `region` (string, 必填)：地区，北京/上海/广东/浙江/江苏
- `topic` (string, 必填)：主题，如竞业补偿/加班费基数/最低工资/产假/婚假
**示例：**
```
get_local_regulations(region="上海", topic="竞业补偿")
```
## 📚 MCP Resources
| URI | 说明 |
|-----|------|
| `risk-knowledge://categories` | 所有风险类别清单 |
| `risk-knowledge://labor` | 劳动关系16类风险清单 |
| `risk-knowledge://service` | 劳务关系9类风险清单 |
| `local-regions://list` | 支持的地区列表 |
## 💬 MCP Prompts
| 名称 | 说明 |
|------|------|
| `contract_review_prompt` | 完整合同审查提示模板 |
| `batch_review_prompt` | 批量审查提示模板 |
## 🔗 集成到客户端
### Claude Desktop
在 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"contract-risk-review": {
"command": "python",
"args": ["/path/to/server.py"],
"env": {
"LLM_API_KEY": "your-api-key",
"LLM_BASE_URL": "https://api.openai.com/v1",
"LLM_MODEL": "gpt-4o-mini"
}
}
}
}
```
### Cursor / Windsurf
在 IDE 的 MCP 配置中添加上述 stdio 配置即可。
### HTTP/SSE 客户端
配置 MCP 服务器地址为 `http://localhost:8000/mcp`。
## 📁 目录结构
```
contract-risk-review-mcp/
├── server.py # MCP Server 主文件
├── requirements.txt # 依赖清单
├── README.md # 使用说明
└── knowledge/ # 知识库
├── risk-knowledge-base.md # 劳动关系16类风险知识库
├── service-contract-risks.md # 劳务关系9类风险知识库
├── local-regulations.md # 地方法规差异知识库
└── categories-index.md # 风险类别索引
```
## ⚠️ 免责声明
本工具仅提供合同风险参考、条款修改建议以及法规依据，**不构成正式法律意见，不能替代执业律师的专业审核**。涉及劳动仲裁、重大权益纠纷，请务必咨询执业律师。
## 📝 更新日志
### v1.0.0
- 初始版本
- 支持劳动合同 16 类风险审查
- 支持劳务合同 9 类风险审查
- 支持批量审查、知识库查询、地方法规查询
- 支持 STDIO 和 HTTP/SSE 两种传输模式