# 明乐智保 MCP（Minglezhibao Insurance Data）

> 中国大陆寿险 / 分红 / 万能险**公开披露数据**的 MCP 服务。
> 数据来源：各保险公司官方公开信息披露（审计报告 / 偿付能力报告 / 分红实现率公告 / 万能险结算利率公告）。

[![Official MCP Registry](https://img.shields.io/badge/Official%20MCP%20Registry-io.github.minglezhibao%2Fmcp-blue)](https://registry.modelcontextprotocol.io)
[![Version](https://img.shields.io/badge/version-1.1.3-green)]()
[![Auth](https://img.shields.io/badge/auth-OAuth%202.1%20%2B%20PKCE-orange)]()

---

## 这是什么

一个 **remote MCP server**（Streamable HTTP），让 AI 助手可以直接查询中国 191 家保险公司的公开数据：
偿付能力、分红实现率、万能险结算利率、保费收入、产品费率与现金价值、投保利益（IRR）等。

**不做什么**：不销售保险、不承保、不收款、不提供投保建议。仅做公开数据查询与解读。

---

## 快速连接

### 端点

```
https://minglezhibao.cn/api/mcp
```

### 认证方式：OAuth 2.1（无需手工申请 API Key）

本服务遵循 **MCP 授权规范 + RFC 9728**，客户端可自动发现授权服务：

```
# 1) 未授权时返回 401，并告知授权服务位置
GET https://minglezhibao.cn/api/mcp
→ 401 Unauthorized
  WWW-Authenticate: Bearer resource_metadata="https://minglezhibao.cn/.well-known/oauth-protected-resource"

# 2) 客户端读取受保护资源元数据
GET https://minglezhibao.cn/.well-known/oauth-protected-resource

# 3) 客户端读取授权服务器元数据（含动态客户端注册 + PKCE S256）
GET https://minglezhibao.cn/.well-known/oauth-authorization-server
```

**支持的授权能力**：`authorization_code` · `refresh_token` · **动态客户端注册** · **PKCE（S256）**
⇒ 常见 MCP 客户端（Claude、Cursor、VS Code、Cline 等）**点一次授权即可**，无需手工贴 Key。

### 客户端配置样例

见本仓 [`mcp.json`](./mcp.json)。

### 免费额度

**每日 30 次**，无需付费即可连接试用。超出后按订阅额度调用。

---

## 9 个工具

工具按「**动词 + 参数**」组织，用 `kind` / `view` / `dataset` 参数区分子能力，而不是拆成一堆工具名。

| # | 工具 | 做什么 | 关键参数 |
|---|---|---|---|
| 1 | `search` | 发现对象（公司 / 产品 / 指标 / 地区 / 文章 / 报告 6 类）| `kind` |
| 2 | `get_product` | 单个产品全貌（6 视角）| `view` |
| 3 | `get_company` | 单个公司全貌（2 视角）| `view` |
| 4 | `get_market` | 行业 / 公司指标（7 数据集）| `dataset` + `view` |
| 5 | `get_ops` | 季度经营指标（4 视角）| `view` |
| 6 | `get_rate` | 负债端利率（预定利率 / 结算利率等）| `kind` + `view` |
| 7 | `calculate` | 投保利益 / 保费换算 / 费率表三语义查询（需代理人身份 + 付费订阅）| — |
| 8 | `get_chart_link` | 生成可分享的图表链接 | — |
| 9 | `submit_insurance_need` | 需求登记（**不占配额**，不构成投保建议）| — |

详见 [`docs/tools.md`](./docs/tools.md)。

---

## 7 个场景 prompts

`prompts/list` 提供 7 个可直接调用的场景菜谱：

`company_scan` · `product_review` · `product_compare` · `pension_planning` · `industry_ranking` 等

---

## 数据覆盖

| 域 | 内容 |
|---|---|
| 公司 | **191 家**中国保险公司：综合评分、8 维度排名、财务摘要 |
| 偿付能力 | 核心 / 综合偿付能力充足率、SARMRA 评分、风险评级（季度粒度） |
| 分红险 | 全行业分红产品历年**分红实现率**（增额 / 终了 / 现金红利），支持公司横向对比 |
| 万能险 | 全行业万能险产品**月度结算利率**历史 |
| 保费 | 全国各省市保费收入（按地区 / 年度 / 月度） |
| 产品 | 数万个寿险 / 年金险产品的**费率表**、**现金价值表**、投保利益与 **IRR** |
| 财务 | 总资产、净利润、ROE、保费收入等 24 项指标历年趋势 |

---

## 示例问法

- 平安人寿的偿付能力和分红实现率怎么样？
- 今年哪几家保险公司分红实现率超过 100%？
- 万能险最新月度结算利率最高的 10 家公司是哪些？
- 30 岁男性年交 5 万的某款增额终身寿，第 20 年现金价值是多少？
- 北京去年的保费收入多少？

---

## 相关链接

- **服务说明**：https://minglezhibao.cn/mcp
- **官方 Registry**：`io.github.minglezhibao/mcp`
- **完整工具文档（含参数 schema）**：https://minglezhibao.cn/llms-full.txt
- **简述（给 AI 读）**：https://minglezhibao.cn/llms.txt

---

## 合规说明

- 本服务仅提供**公开披露信息**的查询与整理，**不构成投保建议**。
- 数据口径以各保险公司官方披露原文为准；历史数据不代表未来。
- 不提供保本、保证收益类表述；不对产品收益优劣作评判。

## License

MIT（见 [LICENSE](./LICENSE)）。数据版权归各原始披露机构所有。