add mcp service shebao tools (#2303)

This commit is contained in:
hourmoneys
2025-05-23 17:27:15 +08:00
committed by GitHub
parent 031ae21caa
commit f6bb5d7729
5 changed files with 487 additions and 0 deletions

0
.tgitconfig Normal file
View File

View File

@@ -0,0 +1,49 @@
# Shebao Tools MCP Server
An implementation of the Model Context Protocol (MCP) server that integrates social security, housing provident fund, disability insurance, income tax, work injury compensation, and work death compensation calculation functions.
## Features
- Calculate social security and housing provident fund fees based on city information. Input the city name and salary information to get detailed calculation results.
- Calculate disability insurance based on enterprise scale. Input the number of employees and average salary of the enterprise to get the calculation result.
- Calculate income tax payment based on individual salary. Input the individual salary to get the payment amount.
- Calculate work injury compensation based on work injury situation. Input the work injury level and salary information to get the compensation amount.
- Calculate work death compensation based on work death situation. Input relevant information to get the compensation amount.
- Detailed list as follows:
1. `getCityCanbaoYear`: Query the year of disability insurance payment for a city based on the city code.
2. `getCityShebaoBase`: Query the disability insurance payment base for a city based on the city code and year.
3. `calcCanbaoCity`: Calculate the recommended number of disabled employees to hire and the cost savings for a city.
4. `getCityPersonDeductRules`: Query the special additional deductions for individual income tax on wages and salaries.
5. `calcCityNormal`: Calculate the detailed individual income tax payment for a city based on the salary.
6. `calcCityLaobar`: Calculate the tax payable for a one-time labor remuneration.
7. `getCityIns`: Query the social security and housing provident fund payment information for a city based on the city ID.
8. `calcCityYearEndBonus`: Calculate the tax payable for an annual one-time bonus.
9. `getCityGm`: Calculate the work death compensation for a city.
10. `getCityAvgSalary`: Query the average salary of the previous year for a city based on the city ID.
11. `getCityDisabilityLevel`: Query the disability levels for a city based on the city ID.
12. `getCityNurseLevel`: Query the nursing levels for a city based on the city ID.
13. `getCityCompensateProject`: Query all types of work injury expenses.
14. `getCityInjuryCData`: Query the calculation rules for work injury expenses.
15. `getCityCalcInjury`: Calculate the work injury expenses for a city based on the city ID and expense type item.
16. `getshebaoInsOrg`: Query the social security policies for a specified city.
17. `calculator`: Calculate the detailed social security and housing provident fund payments for a city.
## Tutorial
### Configure API Key
In the `mcp-server.yaml` file, set the `apikey` field to a valid API key.
### Knowledge Base
1. Import `city_data.xls` into the knowledge base.
### Integrate into MCP Client
On the user's MCP Client interface, add the relevant configuration to the MCP Server list.
```json
"mcpServers": {
"jr-shebao-calc": {
"url": "https://agent-tools.jrit.top/sse?jr-api-key={jr-api-key}",
}
}

View File

@@ -0,0 +1,53 @@
# Shebao Tools MCP Server
一个集成了社保、公积金、残保金、个税、工伤赔付和工亡赔付计算功能的模型上下文协议MCP服务器实现。
## 功能
- 根据城市信息计算社保、公积金费用。输入城市名称和薪资信息,返回详细计算结果。
- 根据城市信息企业规模计算残保金。输入企业员工数量和平均薪资,返回计算结果。
- 根据城市信息个人薪资计算个税缴纳费用。输入个人薪资,返回缴纳费用。
- 根据城市信息工伤情况计算赔付费用。输入工伤等级和薪资信息,返回赔付费用。
- 根据城市信息工亡情况计算赔付费用。输入相关信息,返回赔付费用。
- 详细清单如下:
1.getCityCanbaoYear 根据城市编码查询该城市缴纳残保金年份
2.getCityShebaoBase 根据城市编码和年份查询该城市缴纳残保金基数
3.calcCanbaoCity 计算该城市推荐雇佣残疾人人数和节省费用
4.getCityPersonDeductRules 查询工资薪金个税专项附加扣除
5.calcCityNormal 根据工资计算该城市个税缴纳明细
6.calcCityLaobar 计算一次性劳务报酬应缴纳税额
7.getCityIns 根据城市ID查询该城市社保和公积金缴费信息
8.calcCityYearEndBonus 计算全年一次性奖金应缴纳税额
9.getCityGm 计算该城市工亡赔偿费用
10.getCityAvgSalary 根据城市ID查询该城市上年度平均工资
11.getCityDisabilityLevel 根据城市ID查询该城市伤残等级
12.getCityNurseLevel 根据城市ID查询该城市护理等级
13.getCityCompensateProject 查询所有工伤费用类型
14.getCityInjuryCData 查询工伤费用计算规则
15.getCityCalcInjury 根据城市ID和费用类型项计算工伤费用
16.getshebaoInsOrg 查询指定城市社保政策
17.calculator 计算该城市社保和公积金缴纳明细
## 使用教程
### 获取 apikey
1. 注册账号 [Create a ID](https://check.junrunrenli.com/#/index?src=higress)
2. 发送邮件to: yuanpeng@junrunrenli.com 标题MCP 内容申请MCP社保计算工具服务并提供你的账号。
### 知识库
1. 导入city_data.xls到知识库中。
### 配置 API Key
`mcp-server.yaml` 文件中,将 `jr-api-key` 字段设置为有效的 API 密钥。
### 集成到 MCP Client
在用户的 MCP Client 界面,将相关配置添加到 MCP Server 列表中。
```json
"mcpServers": {
"jr-shebao-calc": {
"url": "https://agent-tools.jrit.top/sse?jr-api-key={jr-api-key}",
}
}

View File

Binary file not shown.

View File

@@ -0,0 +1,385 @@
server:
name: shebao-tools-api-server
config:
apikey: ""
tools:
- name: calculate_social_security
description: |+
根据城市信息计算社保、公积金费用。
- 输入城市名称和薪资信息。
- 返回社保和公积金的详细计算结果。
args:
- name: city
description: 城市名称
type: string
required: true
- name: salary
description: 个人薪资
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools?jr-api-key={apikey}
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calculate_disability_insurance
description: |+
根据企业规模计算残保金。
- 输入企业员工数量和平均薪资。
- 返回残保金的计算结果。
args:
- name: employee_count
description: 企业员工数量
type: integer
required: true
- name: average_salary
description: 企业平均薪资
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools?jr-api-key={apikey}
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calculate_income_tax
description: |+
根据个人薪资计算个税缴纳费用。
- 输入个人薪资。
- 返回个税缴纳费用。
args:
- name: salary
description: 个人薪资
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools?jr-api-key={apikey}
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calculate_work_injury_compensation
description: |+
根据工伤情况计算赔付费用。
- 输入工伤等级和薪资信息。
- 返回工伤赔付费用。
args:
- name: injury_level
description: 工伤等级
type: string
required: true
- name: salary
description: 个人薪资
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools?jr-api-key={apikey}
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calculate_work_death_compensation
description: |+
根据工亡情况计算赔付费用。
- 输入相关信息。
- 返回工亡赔付费用。
args:
- name: relevant_info
description: 相关信息(可根据实际情况细化)
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools?jr-api-key={apikey}
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityCanbaoYear
description: 根据城市编码查询该城市缴纳残保金年份
args:
- name: city_code
description: 城市编码
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityCanbaoYear
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityShebaoBase
description: 根据城市编码和年份查询该城市缴纳残保金基数
args:
- name: city_code
description: 城市编码
type: string
required: true
- name: year
description: 年份
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityShebaoBase
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calcCanbaoCity
description: 计算该城市推荐雇佣残疾人人数和节省费用
args:
- name: city_code
description: 城市编码
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/calcCanbaoCity
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityPersonDeductRules
description: 查询工资薪金个税专项附加扣除
args:
- name: city_code
description: 城市编码
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityPersonDeductRules
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calcCityNormal
description: 根据工资计算该城市个税缴纳明细
args:
- name: city_code
description: 城市编码
type: string
required: true
- name: salary
description: 个人薪资
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/calcCityNormal
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calcCityLaobar
description: 计算一次性劳务报酬应缴纳税额
args:
- name: city_code
description: 城市编码
type: string
required: true
- name: labor_income
description: 一次性劳务报酬
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/calcCityLaobar
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityIns
description: 根据城市ID查询该城市社保和公积金缴费信息
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityIns
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calcCityYearEndBonus
description: 计算全年一次性奖金应缴纳税额
args:
- name: city_code
description: 城市编码
type: string
required: true
- name: year_end_bonus
description: 全年一次性奖金
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/calcCityYearEndBonus
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityGm
description: 计算该城市工亡赔偿费用
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityGm
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityAvgSalary
description: 根据城市ID查询该城市上年度平均工资
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityAvgSalary
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityDisabilityLevel
description: 根据城市ID查询该城市伤残等级
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityDisabilityLevel
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityNurseLevel
description: 根据城市ID查询该城市护理等级
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityNurseLevel
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityCompensateProject
description: 查询所有工伤费用类型
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityCompensateProject
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityInjuryCData
description: 查询工伤费用计算规则
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityInjuryCData
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getCityCalcInjury
description: 根据城市ID和费用类型项计算工伤费用
args:
- name: city_id
description: 城市ID
type: string
required: true
- name: expense_type
description: 费用类型项
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getCityCalcInjury
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: getshebaoInsOrg
description: 查询指定城市社保政策
args:
- name: city_id
description: 城市ID
type: string
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/getshebaoInsOrg
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"
- name: calculator
description: 计算该城市社保和公积金缴纳明细
args:
- name: city
description: 城市名称
type: string
required: true
- name: salary
description: 个人薪资
type: number
required: true
requestTemplate:
argsToUrlParam: true
url: https://agent-tools.jrit.top/agent/tools/calculator
method: GET
headers:
- key: jr-api-key
value: "{{.config.apikey}}"