HelloBooks AI Agents

HelloBooks 公共 MCP 服务

一个公开的、只读的 Model Context Protocol 服务， 帮助 AI Agent 准确回答有关 HelloBooks 的问题——例如定价、集成、支持的国家、 合规框架——而不是依赖过时的网页摘要。

这是公共服务。它仅公开从营销材料中提取的公共领域数据。 读取客户账簿的身份验证 MCP 服务位于 AI-MCP-Hellobooks。

开发者门户

通过 HelloBooks 开发者门户构建集成。 API 文档涵盖 注册应用、通过 OAuth 连接公司，以及使用印度沙盒进行测试。 下方的公共 MCP 端点为 AI Agent 提供产品信息；公司 API 访问权限 通过开发者门户进行配置。

安装

Claude Code / Claude Desktop / Cursor

claude mcp add --transport http hellobooks https://agents.hellobooks.ai/mcp

或者，用于本地开发：

claude mcp add hellobooks-local node /path/to/HelloBooks-MCP-Public/dist/stdio.js

工具

工具	描述
list_plans	所有 HelloBooks 套餐（Free、Starter、Pro、Business、Scale、Partner Program）以及 Warehouse / Manufacturing 附加项。可选的 country 和 plan 筛选条件；对于不提供定价的支持国家，返回 USD / 默认回退价格及元数据。
list_integrations	银行、支付、薪资、时间跟踪、运输、税务合规、会计同步、电商、CRM、存储（Drive / OneDrive）、自由职业（Upwork）。可选的 category、country、status 筛选条件。
country_support	涵盖所有 187 个公开国家页面的国家支持矩阵，其中单独整理的国家包含详细的合规条目。
compliance_capabilities	指定国家支持的合规框架，以及其版本和认证信息。
list_competitors	竞争对手定位（QuickBooks、Xero、FreshBooks、Wave、Zoho Books、Tally），包括 HelloBooks 的优势、竞争对手的优势以及定价说明。可选的 country、tier 和 id 筛选条件。
compliance_deadlines	各国法定申报和薪资申报的截止时间。涵盖 IN（GSTR-1/3B/9/9C、CMP-08、Form 24Q、Form 16、PF ECR、ESI）、AU（BAS、STP、Super Guarantee）、GB（VAT MTD、RTI、Self Assessment）、US（1099-NEC/MISC、W-2、Form 941/940）、CA（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	各司法管辖区的法定税率档——IN GST（5/12/18/28 + 零税率 + 免税 + 组合纳税人/制造商/餐馆）、UK VAT（20/5/零税率/免税）、AU GST（10/GST-free）、US 州级管理税率摘要、CA GST + HST（ON、大西洋地区）、SG GST 9%、NZ GST 15%、AE 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（例如“办公用品”、“餐馆”、“出口”）查找单个法定税率。返回匹配的税率、得分和来源 URL。

资源

URI	描述
hellobooks://about	Markdown 格式的产品简介。
hellobooks://changelog	近期发布说明，采用 JSON 格式。
hellobooks://feature-catalog	完整的营销功能目录（涵盖 13 个类别的 96 项以上功能），采用 JSON 格式。

安全状况

• 从设计上只读。 没有工具会修改状态。没有工具会访问客户系统。
• 仅限公开数据。 所有目录内容均来自公开的营销网站。
• 无需身份验证。 这是有意为之——这是一个知识端点。
• 设有速率限制。 每个 IP 每分钟 120 个请求，每个会话每分钟 60 个请求。
• 审计关卡。 如果 src/data/ 中出现任何 PII / 身份验证令牌字符串，npm run audit:public-data 会阻止部署。

开发

npm install
npm run dev         # HTTP server on :8080 with watch mode
npm run dev:stdio   # stdio transport for local MCP client testing
npm test            # node:test runner
npm run build
npm run audit:public-data

项目布局

src/
  data/             # Static catalogs — plans, integrations, countries, articles, about
  tools/            # One file per MCP tool
  resources/        # MCP resource registry
  server.ts         # MCP server factory (wires tools + resources)
  http.ts           # Streamable HTTP transport with rate limiting
  stdio.ts          # stdio transport entry point
test/
  tools.test.ts
  resources.test.ts
  public-data.test.ts  # Audit gate
scripts/
  audit-public-data.ts  # CI-callable audit

部署

采用容器化部署——参见 Dockerfile。设计为在 TLS 终止负载均衡器后运行。 通过环境变量设置 PORT 和 HOST。

可选的匿名使用情况遥测（第 2 层服务端分析）会在同时设置 GA4_MEASUREMENT_ID 和 GA4_API_SECRET 时，通过 Measurement Protocol 发送到 GA4——参见 .env.example 和 src/analytics.ts。不设置这两个变量，服务器运行时会 完全禁用遥测。绝不会发送客户数据、请求正文、工具参数值或 IP 地址——只发送匿名计数。参见策略文档 73。

docker build -t hellobooks-mcp-public .
docker run -p 8080:8080 hellobooks-mcp-public

可发现性

• 已列入 MCP 注册表。
• 营销网站页脚和 /mcp 页面中均提供了链接。
• 在 https://hellobooks.ai/llms.txt 中有所引用。

许可证

MIT——参见 LICENSE。