Metadata-Version: 2.4
Name: worth-calculator-mcp-39532
Version: 0.1.0
Summary: MCP tool for calculating job worth (B班值不值)
Author: Your Name
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: mcp
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Worth Calculator MCP

基于开源项目 [Zippland/worth-calculator](https://github.com/Zippland/worth-calculator) 的核心公式，实现可在 MCP 中调用的「工作性价比（B班值不值）」计算工具。

## 项目结构（用于发布 PyPI）

```text
worth-calculator-mcp/
├── worth_calculator_tool/
│   ├── __init__.py
│   └── main.py
├── worth_calculator_mcp.py
├── setup.py
├── README.md
├── requirements.txt
└── local_test_mcp.json
```

## 提供工具

- `calculate_job_worth`

## 安装

```bash
pip install -r requirements.txt
```

## 启动

```bash
python worth_calculator_tool/main.py
```

## 参数说明（核心）

- `annual_salary`: 年薪（必填）
- `country_code`: 国家代码（如 `CN` / `US` / `JP`），用于 PPP 折算
- `work_days_per_week`, `wfh_days_per_week`
- `annual_leave`, `paid_sick_leave`, `public_holidays`
- `work_hours`, `commute_hours`, `rest_time`
- `city_factor`, `work_environment`, `leadership`, `teamwork`
- `has_shuttle`, `shuttle_factor`
- `has_canteen`, `canteen_factor`
- `degree_type`, `school_type`, `bachelor_type`
- `work_years`, `job_stability`

## 返回结果

返回 JSON，包含：

- `job_value`: 核心性价比分数
- `rating_cn`: 中文评级（如 `一般` / `很爽` / `人生巅峰`）
- `rating_key`: 对应原项目评级键
- `intermediate`: 关键中间变量，便于审计公式

## 本地测试（步骤2）

你可以把 `local_test_mcp.json` 导入到 MCP 客户端进行本地测试。  
也可直接在 Cursor 中保留当前 `worth-calculator-mcp` 配置并调用工具 `calculate_job_worth` 验证。

## 发布到 PyPI（步骤3）

1. 安装构建工具：
   - `pip install -r requirements.txt`
2. 构建：
   - `python -m build`
3. （推荐）先传 TestPyPI：
   - `twine upload --repository testpypi dist/*`
4. 正式上传 PyPI（使用 API Token）：
   - `twine upload dist/*`

### Token 使用方式（推荐）

- 用户名：`__token__`
- 密码：`pypi-xxxx`（你的 API Token）

⚠️ 注意：

- 包名必须唯一；若 `worth-calculator-mcp` 已被占用，需要改 `setup.py` 的 `name`
- 每次发布需更新 `version`
- 我不能替你注册账号或生成 token；你提供 token 后我可以继续代你执行上传命令
