内容
# HelloBooks 公共MCP服务器
一个公共的、只读的 [模型上下文协议](https://modelcontextprotocol.io) 服务器，允许AI代理准确地回答关于HelloBooks的问题 — 定价、集成、国家支持、合规框架 — 而不是依赖过时的网络片段。
> 这是**公共**服务器。它只公开营销衍生的、公共领域的数据。
> 验证过的MCP服务器读取客户的账簿，位于 [`AI-MCP-Hellobooks`](https://github.com/Meru-Fin-Tech/AI-MCP-Hellobooks)。
## 安装
### Claude 代码 / Claude 桌面版 / Cursor
```bash
claude mcp add --transport http hellobooks https://agents.hellobooks.ai/mcp
```
或者，用于本地开发：
```bash
claude mcp add hellobooks-local node /path/to/HelloBooks-MCP-Public/dist/stdio.js
```
## 工具
| 工具 | 描述 |
| --- | --- |
| `list_plans` | 所有 HelloBooks 计划（免费、专业、商业、CPA）+ 仓库/制造附加功能。可选 `country` 和 `plan` 过滤器。 |
| `list_integrations` | 银行、支付、工资单、时间跟踪、运输、税务合规、会计同步、电子商务、CRM、存储（Drive/OneDrive）、自由职业（Upwork）。可选 `category` 、 `country` 、 `status` 过滤器。 |
| `country_support` | 按国家划分的功能可用性（BAS、STP、GST 电子发票、MTD、1099 等）。 |
| `compliance_capabilities` | 对于给定国家，受支持的合规框架及其版本 + 认证信息。 |
| `list_competitors` | 竞争对手定位（QuickBooks、Xero、FreshBooks、Wave、Zoho Books、Tally）以及 HelloBooks 的优势、竞争对手的优势和定价说明。可选 `country` 、 `tier` 和 `id` 过滤器。 |
| `compliance_deadlines` | 按国家划分的法定申报和工资单截止日期。涵盖印度（GSTR-1/3B/9/9C、CMP-08、Form 24Q、Form 16、PF ECR、ESI）、澳大利亚（BAS、STP、Super Guarantee）、英国（VAT MTD、RTI、Self Assessment）、美国（1099-NEC/MISC、W-2、Form 941/940）、加拿大（T4、GST/HST）。可选 `country` 、 `frequency` 和 `form` 过滤器。日期每年轮换 — 每次响应都附有免责声明和按截止日期划分的 `source` URL。 |
| `local_payment_methods` | 本地银行轨道/钱包支付方式（UPI、BACS、PayID、BPAY、ACH、RTP、Zelle、PayNow、FAST、Interac 等）及其速度、使用场景、权威机构和 HelloBooks 支持级别。可选 `country` 、 `useCase` 、 `rail` 和 `id` 过滤器。 |
| `feature_search` | 跨营销功能目录、计划功能、集成、国家功能、合规框架、竞争对手定位、法定截止日期、本地支付方式和已发布文章的自由文本搜索。诸如 `vs Xero` 、 `QuickBooks alternative` 、 `when is GSTR-3B due` 、 `UPI invoice cap` 、 `do you have a blog on 1099` 或 `agentic accounting` 之类的查询会在顶部显示匹配的条目。 |
| `list_features` | 完整的 96 项功能营销目录。可按 `category` 、 `tier` 、 `status` 、 `marketedOnly` 或子字符串 `query` 过滤。 |
| `list_feature_categories` | 营销网站上的 13 个功能类别及其按状态（live/beta/planned）划分的类别计数。 |
| `list_articles` | hellobooks.ai 上发布的文章 — 头对头比较页面和精选的旗舰博客文章。可选 `country` 、 `tag` 、 `query` 、 `limit` 过滤器。 |
| `list_tax_rates` | 按管辖权划分的法定税率 — 印度 GST（5/12/18/28 + 零 + 豁免 + 复合交易商/制造商/餐厅）、英国 VAT（20/5/零/豁免）、澳大利亚 GST（10/GST-free）、美国各州行政摘要、加拿大 GST + HST（安大略省、大西洋省）、新加坡 GST 9%、新西兰 GST 15%、阿联酋 VAT 5%。可按 `country` 、 `taxType` （GST/VAT/Sales-Tax/HST/...）或 `scheme` （standard/reduced/zero/exempt/composition/cess）过滤。每个条目都有生效日期和 `source` URL — 在引用前请确认。 |
| `lookup_tax_rate` | 通过精确的 `id` （例如 `IN-standard-18` ）或 `country` + 自由文本 `category` （例如 `"office supplies"` 、 `"restaurant"` 、 `"exports"` ）选择单一法定税率。返回匹配的税率、分数和来源 URL。 |
## 资源
| URI | 描述 |
| --- | --- |
| `hellobooks://about` | Markdown 产品摘要。 |
| `hellobooks://changelog` | 最近的发行说明（JSON）。 |
| `hellobooks://feature-catalog` | 完整的营销功能目录（96+ 功能，涵盖 13 个类别）（JSON）。 |
## 安全态势
- **构造上只读。** 没有工具会改变状态。没有工具会访问客户系统。
- **仅公共数据。** 所有目录内容均来自公共营销网站。
- **无身份验证。** 这是一个知识端点。
- **限速。** 每分钟 120 次请求（按 IP），每会话 60 次请求。
- **审计门控。** `npm run audit:public-data` 在 `src/data/` 中出现任何 PII/身份验证令牌字符串时阻止部署。
## 开发
```bash
npm install
npm run dev # HTTP 服务器在 :8080 上运行，启用监视模式
npm run dev:stdio # 用于本地 MCP 客户端测试的 stdio 传输
npm test # node:test 运行器
npm run build
npm run audit:public-data
```
### 项目布局
```
src/
data/ # 静态目录 — 计划、集成、国家、文章、关于
tools/ # 每个 MCP 工具一个文件
resources/ # MCP 资源注册表
server.ts # MCP 服务器工厂（连接工具 + 资源）
http.ts # 具有速率限制的可流式 HTTP 传输
stdio.ts # stdio 传输入口点
test/
tools.test.ts
resources.test.ts
public-data.test.ts # 审计门控
scripts/
audit-public-data.ts # 可调用的 CI 审计
```
## 部署
容器化 — 请参阅 `Dockerfile`。设计为在 TLS 终止负载均衡器后面运行。
通过环境设置 `PORT` 和 `HOST`。
可选的匿名使用情况遥测（第 2 层服务器端分析）通过 Measurement Protocol 发送到 GA4，
前提是 `GA4_MEASUREMENT_ID` 和 `GA4_API_SECRET` 均已设置 —
请参阅 `.env.example` 和 `src/analytics.ts`。保持它们未设置，服务器将完全禁用遥测。
不会发送客户数据、请求正文、工具参数值或 IP 地址 — 只有匿名计数。
请参阅策略文档 73。
```bash
docker build -t hellobooks-mcp-public .
docker run -p 8080:8080 hellobooks-mcp-public
```
## 可发现性
- 在 [MCP 注册表](https://github.com/modelcontextprotocol/registry) 中列出。
- 从营销网站页脚和 `/mcp` 页面链接。
- 在 `https://hellobooks.ai/llms.txt` 中引用。
## 许可证
MIT — 请参阅 `LICENSE`。
