# 🚀 工作性价比计算器MCP工具
基于worth-calculator项目的全面工作价值计算MCP工具，支持190+国家/地区的薪资标准化比较。
## ✨ 功能特点
- **全面评估**：超越单纯薪资考量，综合工作时长、通勤、工作环境等多维度因素
- **国际比较**：支持190+国家/地区的PPP购买力平价转换
- **教育加成**：考虑学历背景和学校层次对薪资的影响
- **经验曲线**：基于工作年限和职业类型的薪资增长预测
- **现代化报告**：生成响应式HTML报告，支持移动端查看
- **未来趋势**：提供各国未来热门职业和薪资趋势预测
## 📊 核心功能
### 1. 工作性价比计算
计算工作性价比的核心公式：
```
性价比 = (日薪 × 环境因子) / (35 × 工作时间 × 教育加成 × 经验倍数)
```
### 2. 国际薪资比较
- 支持190+国家/地区的PPP购买力平价转换
- 以人民币为基准的薪资标准化
- 实时货币符号显示
### 3. HTML报告生成
- 现代化响应式设计
- 动画效果和交互体验
- 30天行动计划建议
- 移动端友好界面
### 4. 未来趋势预测
- 各国热门职业薪资预测
- 5年薪资增长趋势
- 关键技能需求分析
## 🚀 快速开始
### 安装
```bash
pip install job-worth-calculator-mcp
```
### 作为MCP工具使用
在Trae AI或其他支持MCP的客户端中配置：
```json
{
"mcpServers": {
"job-worth-calculator": {
"command": "uvx",
"args": ["job-worth-calculator-mcp"]
}
}
}
```
### 命令行使用
```bash
# 启动MCP服务器
job-worth-calculator-mcp
# 生成示例报告
job-worth-calculator-mcp --generate-report
```
## 📖 使用示例
### 基本工作性价比计算
```python
from job_worth_calculator_mcp.main import calculate_job_worth
result = calculate_job_worth(
annual_salary=300000,
country="CN",
work_days_per_week=5,
work_hours=9,
commute_hours=1.5,
wfh_days=2,
annual_leave=10,
education_level="master",
work_years=3
)
print(f"工作性价比评分: {result['score']}")
print(f"评估结果: {result['assessment']}")
```
### 生成HTML报告
```python
from job_worth_calculator_mcp.main import save_html_report
# 使用上面的计算结果
save_result = save_html_report(result, params)
print(f"报告已保存: {save_result['filename']}")
```
### 获取支持的国家列表
```python
from job_worth_calculator_mcp.main import get_supported_countries
countries = get_supported_countries()
print(f"支持{countries['total_countries']}个国家/地区")
```
### 未来趋势预测
```python
from job_worth_calculator_mcp.main import future_job_trends
trends = future_job_trends(country="CN", years_ahead=5)
for job in trends['hot_jobs'][:5]:
print(f"{job['job']}: {job['growth']}%增长")
```
## 🌍 支持的国家/地区
覆盖全球主要经济体，包括：
- 东亚：中国、日本、韩国、香港、台湾等
- 东南亚：新加坡、泰国、越南、马来西亚等
- 欧洲：英国、德国、法国、意大利等
- 北美：美国、加拿大、墨西哥
- 南美：巴西、阿根廷、智利等
- 澳洲：澳大利亚、新西兰
完整列表可通过 `get_supported_countries()` 获取。
## 📊 评分标准
| 评分范围 | 等级 | 说明 |
|---------|------|------|
| ≥2.0 | Excellent | 神仙工作！高薪轻松 |
| 1.5-2.0 | Good | 还不错的工作 |
| 1.0-1.5 | Fair | 一般般，可作跳板 |
| 0.7-1.0 | Poor | 性价比偏低 |
| <0.7 | Terrible | 快跑！血汗工厂 |
## 🎯 使用场景
- **求职决策**：评估offer性价比
- **薪资谈判**：了解市场薪资水平
- **职业规划**：制定技能提升计划
- **国际比较**：跨国工作机会评估
- **团队管理**：了解员工满意度因素
## 🔧 技术特性
- **MCP兼容**：完全符合MCP协议标准
- **响应式设计**：支持桌面端和移动端
- **国际化**：支持多国家/地区薪资标准
- **实时计算**：即时生成分析结果
- **可视化报告**：美观的HTML报告输出
## 📈 未来规划
- [ ] 支持更多行业特定参数
- [ ] 添加历史薪资趋势分析
- [ ] 集成更多外部数据源
- [ ] 支持团队协作功能
- [ ] 添加薪资预测模型
## 🤝 贡献
欢迎提交Issue和Pull Request来改进这个项目！
## 📄 许可证
MIT License - 详见 [LICENSE](LICENSE) 文件
## 🔗 相关链接
- [worth-calculator原项目](https://github.com/ai/worth-calculator)
- [MCP协议文档](https://modelcontextprotocol.io)
- [PyPI包页面](https://pypi.org/project/job-worth-calculator-mcp/)
Raw data
{
"_id": null,
"home_page": "https://github.com/ai/job-worth-calculator-mcp",
"name": "job-worth-calculator-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mcp, job, worth, calculator, salary, comparison, career",
"author": "AI\u52a9\u624b",
"author_email": "ai@example.com",
"download_url": "https://files.pythonhosted.org/packages/fd/c9/56f3d07981d32b3b271ef50b15e759d56680aee476d084582304ada00325/job_worth_calculator_mcp-1.0.0.tar.gz",
"platform": null,
"description": "# \ud83d\ude80 \u5de5\u4f5c\u6027\u4ef7\u6bd4\u8ba1\u7b97\u5668MCP\u5de5\u5177\r\n\r\n\u57fa\u4e8eworth-calculator\u9879\u76ee\u7684\u5168\u9762\u5de5\u4f5c\u4ef7\u503c\u8ba1\u7b97MCP\u5de5\u5177\uff0c\u652f\u6301190+\u56fd\u5bb6/\u5730\u533a\u7684\u85aa\u8d44\u6807\u51c6\u5316\u6bd4\u8f83\u3002\r\n\r\n## \u2728 \u529f\u80fd\u7279\u70b9\r\n\r\n- **\u5168\u9762\u8bc4\u4f30**\uff1a\u8d85\u8d8a\u5355\u7eaf\u85aa\u8d44\u8003\u91cf\uff0c\u7efc\u5408\u5de5\u4f5c\u65f6\u957f\u3001\u901a\u52e4\u3001\u5de5\u4f5c\u73af\u5883\u7b49\u591a\u7ef4\u5ea6\u56e0\u7d20\r\n- **\u56fd\u9645\u6bd4\u8f83**\uff1a\u652f\u6301190+\u56fd\u5bb6/\u5730\u533a\u7684PPP\u8d2d\u4e70\u529b\u5e73\u4ef7\u8f6c\u6362\r\n- **\u6559\u80b2\u52a0\u6210**\uff1a\u8003\u8651\u5b66\u5386\u80cc\u666f\u548c\u5b66\u6821\u5c42\u6b21\u5bf9\u85aa\u8d44\u7684\u5f71\u54cd\r\n- **\u7ecf\u9a8c\u66f2\u7ebf**\uff1a\u57fa\u4e8e\u5de5\u4f5c\u5e74\u9650\u548c\u804c\u4e1a\u7c7b\u578b\u7684\u85aa\u8d44\u589e\u957f\u9884\u6d4b\r\n- **\u73b0\u4ee3\u5316\u62a5\u544a**\uff1a\u751f\u6210\u54cd\u5e94\u5f0fHTML\u62a5\u544a\uff0c\u652f\u6301\u79fb\u52a8\u7aef\u67e5\u770b\r\n- **\u672a\u6765\u8d8b\u52bf**\uff1a\u63d0\u4f9b\u5404\u56fd\u672a\u6765\u70ed\u95e8\u804c\u4e1a\u548c\u85aa\u8d44\u8d8b\u52bf\u9884\u6d4b\r\n\r\n## \ud83d\udcca \u6838\u5fc3\u529f\u80fd\r\n\r\n### 1. \u5de5\u4f5c\u6027\u4ef7\u6bd4\u8ba1\u7b97\r\n\u8ba1\u7b97\u5de5\u4f5c\u6027\u4ef7\u6bd4\u7684\u6838\u5fc3\u516c\u5f0f\uff1a\r\n```\r\n\u6027\u4ef7\u6bd4 = (\u65e5\u85aa \u00d7 \u73af\u5883\u56e0\u5b50) / (35 \u00d7 \u5de5\u4f5c\u65f6\u95f4 \u00d7 \u6559\u80b2\u52a0\u6210 \u00d7 \u7ecf\u9a8c\u500d\u6570)\r\n```\r\n\r\n### 2. \u56fd\u9645\u85aa\u8d44\u6bd4\u8f83\r\n- \u652f\u6301190+\u56fd\u5bb6/\u5730\u533a\u7684PPP\u8d2d\u4e70\u529b\u5e73\u4ef7\u8f6c\u6362\r\n- \u4ee5\u4eba\u6c11\u5e01\u4e3a\u57fa\u51c6\u7684\u85aa\u8d44\u6807\u51c6\u5316\r\n- \u5b9e\u65f6\u8d27\u5e01\u7b26\u53f7\u663e\u793a\r\n\r\n### 3. HTML\u62a5\u544a\u751f\u6210\r\n- \u73b0\u4ee3\u5316\u54cd\u5e94\u5f0f\u8bbe\u8ba1\r\n- \u52a8\u753b\u6548\u679c\u548c\u4ea4\u4e92\u4f53\u9a8c\r\n- 30\u5929\u884c\u52a8\u8ba1\u5212\u5efa\u8bae\r\n- \u79fb\u52a8\u7aef\u53cb\u597d\u754c\u9762\r\n\r\n### 4. \u672a\u6765\u8d8b\u52bf\u9884\u6d4b\r\n- \u5404\u56fd\u70ed\u95e8\u804c\u4e1a\u85aa\u8d44\u9884\u6d4b\r\n- 5\u5e74\u85aa\u8d44\u589e\u957f\u8d8b\u52bf\r\n- \u5173\u952e\u6280\u80fd\u9700\u6c42\u5206\u6790\r\n\r\n## \ud83d\ude80 \u5feb\u901f\u5f00\u59cb\r\n\r\n### \u5b89\u88c5\r\n\r\n```bash\r\npip install job-worth-calculator-mcp\r\n```\r\n\r\n### \u4f5c\u4e3aMCP\u5de5\u5177\u4f7f\u7528\r\n\r\n\u5728Trae AI\u6216\u5176\u4ed6\u652f\u6301MCP\u7684\u5ba2\u6237\u7aef\u4e2d\u914d\u7f6e\uff1a\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"job-worth-calculator\": {\r\n \"command\": \"uvx\",\r\n \"args\": [\"job-worth-calculator-mcp\"]\r\n }\r\n }\r\n}\r\n```\r\n\r\n### \u547d\u4ee4\u884c\u4f7f\u7528\r\n\r\n```bash\r\n# \u542f\u52a8MCP\u670d\u52a1\u5668\r\njob-worth-calculator-mcp\r\n\r\n# \u751f\u6210\u793a\u4f8b\u62a5\u544a\r\njob-worth-calculator-mcp --generate-report\r\n```\r\n\r\n## \ud83d\udcd6 \u4f7f\u7528\u793a\u4f8b\r\n\r\n### \u57fa\u672c\u5de5\u4f5c\u6027\u4ef7\u6bd4\u8ba1\u7b97\r\n\r\n```python\r\nfrom job_worth_calculator_mcp.main import calculate_job_worth\r\n\r\nresult = calculate_job_worth(\r\n annual_salary=300000,\r\n country=\"CN\",\r\n work_days_per_week=5,\r\n work_hours=9,\r\n commute_hours=1.5,\r\n wfh_days=2,\r\n annual_leave=10,\r\n education_level=\"master\",\r\n work_years=3\r\n)\r\nprint(f\"\u5de5\u4f5c\u6027\u4ef7\u6bd4\u8bc4\u5206: {result['score']}\")\r\nprint(f\"\u8bc4\u4f30\u7ed3\u679c: {result['assessment']}\")\r\n```\r\n\r\n### \u751f\u6210HTML\u62a5\u544a\r\n\r\n```python\r\nfrom job_worth_calculator_mcp.main import save_html_report\r\n\r\n# \u4f7f\u7528\u4e0a\u9762\u7684\u8ba1\u7b97\u7ed3\u679c\r\nsave_result = save_html_report(result, params)\r\nprint(f\"\u62a5\u544a\u5df2\u4fdd\u5b58: {save_result['filename']}\")\r\n```\r\n\r\n### \u83b7\u53d6\u652f\u6301\u7684\u56fd\u5bb6\u5217\u8868\r\n\r\n```python\r\nfrom job_worth_calculator_mcp.main import get_supported_countries\r\n\r\ncountries = get_supported_countries()\r\nprint(f\"\u652f\u6301{countries['total_countries']}\u4e2a\u56fd\u5bb6/\u5730\u533a\")\r\n```\r\n\r\n### \u672a\u6765\u8d8b\u52bf\u9884\u6d4b\r\n\r\n```python\r\nfrom job_worth_calculator_mcp.main import future_job_trends\r\n\r\ntrends = future_job_trends(country=\"CN\", years_ahead=5)\r\nfor job in trends['hot_jobs'][:5]:\r\n print(f\"{job['job']}: {job['growth']}%\u589e\u957f\")\r\n```\r\n\r\n## \ud83c\udf0d \u652f\u6301\u7684\u56fd\u5bb6/\u5730\u533a\r\n\r\n\u8986\u76d6\u5168\u7403\u4e3b\u8981\u7ecf\u6d4e\u4f53\uff0c\u5305\u62ec\uff1a\r\n- \u4e1c\u4e9a\uff1a\u4e2d\u56fd\u3001\u65e5\u672c\u3001\u97e9\u56fd\u3001\u9999\u6e2f\u3001\u53f0\u6e7e\u7b49\r\n- \u4e1c\u5357\u4e9a\uff1a\u65b0\u52a0\u5761\u3001\u6cf0\u56fd\u3001\u8d8a\u5357\u3001\u9a6c\u6765\u897f\u4e9a\u7b49\r\n- \u6b27\u6d32\uff1a\u82f1\u56fd\u3001\u5fb7\u56fd\u3001\u6cd5\u56fd\u3001\u610f\u5927\u5229\u7b49\r\n- \u5317\u7f8e\uff1a\u7f8e\u56fd\u3001\u52a0\u62ff\u5927\u3001\u58a8\u897f\u54e5\r\n- \u5357\u7f8e\uff1a\u5df4\u897f\u3001\u963f\u6839\u5ef7\u3001\u667a\u5229\u7b49\r\n- \u6fb3\u6d32\uff1a\u6fb3\u5927\u5229\u4e9a\u3001\u65b0\u897f\u5170\r\n\r\n\u5b8c\u6574\u5217\u8868\u53ef\u901a\u8fc7 `get_supported_countries()` \u83b7\u53d6\u3002\r\n\r\n## \ud83d\udcca \u8bc4\u5206\u6807\u51c6\r\n\r\n| \u8bc4\u5206\u8303\u56f4 | \u7b49\u7ea7 | \u8bf4\u660e |\r\n|---------|------|------|\r\n| \u22652.0 | Excellent | \u795e\u4ed9\u5de5\u4f5c\uff01\u9ad8\u85aa\u8f7b\u677e |\r\n| 1.5-2.0 | Good | \u8fd8\u4e0d\u9519\u7684\u5de5\u4f5c |\r\n| 1.0-1.5 | Fair | \u4e00\u822c\u822c\uff0c\u53ef\u4f5c\u8df3\u677f |\r\n| 0.7-1.0 | Poor | \u6027\u4ef7\u6bd4\u504f\u4f4e |\r\n| <0.7 | Terrible | \u5feb\u8dd1\uff01\u8840\u6c57\u5de5\u5382 |\r\n\r\n## \ud83c\udfaf \u4f7f\u7528\u573a\u666f\r\n\r\n- **\u6c42\u804c\u51b3\u7b56**\uff1a\u8bc4\u4f30offer\u6027\u4ef7\u6bd4\r\n- **\u85aa\u8d44\u8c08\u5224**\uff1a\u4e86\u89e3\u5e02\u573a\u85aa\u8d44\u6c34\u5e73\r\n- **\u804c\u4e1a\u89c4\u5212**\uff1a\u5236\u5b9a\u6280\u80fd\u63d0\u5347\u8ba1\u5212\r\n- **\u56fd\u9645\u6bd4\u8f83**\uff1a\u8de8\u56fd\u5de5\u4f5c\u673a\u4f1a\u8bc4\u4f30\r\n- **\u56e2\u961f\u7ba1\u7406**\uff1a\u4e86\u89e3\u5458\u5de5\u6ee1\u610f\u5ea6\u56e0\u7d20\r\n\r\n## \ud83d\udd27 \u6280\u672f\u7279\u6027\r\n\r\n- **MCP\u517c\u5bb9**\uff1a\u5b8c\u5168\u7b26\u5408MCP\u534f\u8bae\u6807\u51c6\r\n- **\u54cd\u5e94\u5f0f\u8bbe\u8ba1**\uff1a\u652f\u6301\u684c\u9762\u7aef\u548c\u79fb\u52a8\u7aef\r\n- **\u56fd\u9645\u5316**\uff1a\u652f\u6301\u591a\u56fd\u5bb6/\u5730\u533a\u85aa\u8d44\u6807\u51c6\r\n- **\u5b9e\u65f6\u8ba1\u7b97**\uff1a\u5373\u65f6\u751f\u6210\u5206\u6790\u7ed3\u679c\r\n- **\u53ef\u89c6\u5316\u62a5\u544a**\uff1a\u7f8e\u89c2\u7684HTML\u62a5\u544a\u8f93\u51fa\r\n\r\n## \ud83d\udcc8 \u672a\u6765\u89c4\u5212\r\n\r\n- [ ] \u652f\u6301\u66f4\u591a\u884c\u4e1a\u7279\u5b9a\u53c2\u6570\r\n- [ ] \u6dfb\u52a0\u5386\u53f2\u85aa\u8d44\u8d8b\u52bf\u5206\u6790\r\n- [ ] \u96c6\u6210\u66f4\u591a\u5916\u90e8\u6570\u636e\u6e90\r\n- [ ] \u652f\u6301\u56e2\u961f\u534f\u4f5c\u529f\u80fd\r\n- [ ] \u6dfb\u52a0\u85aa\u8d44\u9884\u6d4b\u6a21\u578b\r\n\r\n## \ud83e\udd1d \u8d21\u732e\r\n\r\n\u6b22\u8fce\u63d0\u4ea4Issue\u548cPull Request\u6765\u6539\u8fdb\u8fd9\u4e2a\u9879\u76ee\uff01\r\n\r\n## \ud83d\udcc4 \u8bb8\u53ef\u8bc1\r\n\r\nMIT License - \u8be6\u89c1 [LICENSE](LICENSE) \u6587\u4ef6\r\n\r\n## \ud83d\udd17 \u76f8\u5173\u94fe\u63a5\r\n\r\n- [worth-calculator\u539f\u9879\u76ee](https://github.com/ai/worth-calculator)\r\n- [MCP\u534f\u8bae\u6587\u6863](https://modelcontextprotocol.io)\r\n- [PyPI\u5305\u9875\u9762](https://pypi.org/project/job-worth-calculator-mcp/)\r\n",
"bugtrack_url": null,
"license": null,
"summary": "\u57fa\u4e8eworth-calculator\u7684\u5168\u9762\u5de5\u4f5c\u6027\u4ef7\u6bd4\u8ba1\u7b97MCP\u5de5\u5177",
"version": "1.0.0",
"project_urls": {
"Bug Reports": "https://github.com/ai/job-worth-calculator-mcp/issues",
"Homepage": "https://github.com/ai/job-worth-calculator-mcp",
"Source": "https://github.com/ai/job-worth-calculator-mcp"
},
"split_keywords": [
"mcp",
" job",
" worth",
" calculator",
" salary",
" comparison",
" career"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "04b0fb12b6a13ee9b19678fd6f5637de76508904c2a3ba29e67294f77a824caf",
"md5": "53e8c994d357d4a63959b5f681aff468",
"sha256": "e5407deab7d6ba51efb684f152aeb3966a0b809461f7697ee9b95df05e23ae0b"
},
"downloads": -1,
"filename": "job_worth_calculator_mcp-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "53e8c994d357d4a63959b5f681aff468",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18223,
"upload_time": "2025-08-24T11:48:34",
"upload_time_iso_8601": "2025-08-24T11:48:34.638925Z",
"url": "https://files.pythonhosted.org/packages/04/b0/fb12b6a13ee9b19678fd6f5637de76508904c2a3ba29e67294f77a824caf/job_worth_calculator_mcp-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fdc956f3d07981d32b3b271ef50b15e759d56680aee476d084582304ada00325",
"md5": "c6efdb69116419755db1cf9c1bf44998",
"sha256": "daf9036837e5a2d49854cbdd83d2971bc28588c8ef72422275510316770090d7"
},
"downloads": -1,
"filename": "job_worth_calculator_mcp-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "c6efdb69116419755db1cf9c1bf44998",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 20000,
"upload_time": "2025-08-24T11:48:35",
"upload_time_iso_8601": "2025-08-24T11:48:35.889270Z",
"url": "https://files.pythonhosted.org/packages/fd/c9/56f3d07981d32b3b271ef50b15e759d56680aee476d084582304ada00325/job_worth_calculator_mcp-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-24 11:48:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ai",
"github_project": "job-worth-calculator-mcp",
"github_not_found": true,
"lcname": "job-worth-calculator-mcp"
}
JSON
