Tax Search MCP

一个面向税务场景的 MCP Server，用于实时搜索国家税务总局、财政部、中国政府网、国家法律法规数据库等官方公开站点，为大模型返回最新税务政策、公告、税率依据和原文链接。

📚 文档导航

用户文档

• 使用指南 - 完整的使用说明和最佳实践
• 使用场景示例 - 实际使用场景和对话示例
• Cherry Studio 配置指南 - Cherry Studio 客户端专用配置

开发文档

• 项目说明文档 - 技术架构和设计原则
• 代码审查和优化建议 - 项目质量分析和改进建议
• 开发进度 - 功能完成度和规划
• 优化总结 - 已完成的优化项目

配置示例

• Claude Desktop 配置 - Claude Desktop 配置示例
• Cherry Studio 配置 - Cherry Studio 配置示例

设计原则

• 不存储业务数据
• 不建立知识库
• 不维护向量数据库
• 实时搜索官方来源
• 返回原文链接与摘要
• 结果以官方原文为准

官方来源

• 国家税务总局：https://www.chinatax.gov.cn
• 财政部：https://www.mof.gov.cn
• 中国政府网：https://www.gov.cn
• 国家法律法规数据库：https://flk.npc.gov.cn

MCP Tools

search_tax_policy

搜索税务政策、法规和通知。

输入示例：

{
  "query": "研发费用加计扣除最新政策"
}

search_tax_notice

搜索税务公告、通知、政策解读。

输入示例：

{
  "query": "最近增值税公告",
  "dateFrom": "2026-05-01"
}

get_tax_document

抓取官方原文页面。

输入示例：

{
  "url": "https://www.chinatax.gov.cn/xxx/content.html"
}

search_tax_rate

搜索税率相关官方依据。

输入示例：

{
  "taxType": "vat",
  "query": "软件开发"
}

本地开发

npm install
npm run build
npm run dev:stdio
npm run dev:http

环境变量配置

项目支持以下环境变量进行配置：

| 环境变量 | 描述 | 可选值 | 默认值 | |---------|------|-------|-------| | TAX_MCP_CACHE | 控制缓存开关 | off / 其他 | 启用 | | LOG_LEVEL | 日志级别 | debug / info / warn / error | info | | LOG_FORMAT | 日志格式 | json / text | json |

示例

# 禁用缓存运行
TAX_MCP_CACHE=off npm run dev:stdio

# 启用 debug 日志
LOG_LEVEL=debug npm run dev:http

# 使用文本格式日志
LOG_FORMAT=text npm run dev:stdio

MCP 客户端配置

Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json 中配置：

{
  "mcpServers": {
    "tax-search": {
      "command": "node",
      "args": ["/absolute/path/to/tax/dist/cli.js", "stdio"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

Cherry Studio

在 Cherry Studio 的设置中添加 MCP 服务器，或编辑配置文件：

{
  "mcpServers": {
    "tax-search": {
      "name": "中国税务政策搜索",
      "command": "node",
      "args": ["/absolute/path/to/tax/dist/cli.js", "stdio"],
      "env": {
        "LOG_LEVEL": "info",
        "TAX_MCP_CACHE": "on"
      },
      "alwaysAllow": ["search_tax_policy", "search_tax_notice"]
    }
  }
}

更多客户端配置详见 使用指南。

限制

• 当前版本主要依赖官方 HTML 搜索页和详情页解析，部分站点结果可能不完整。
• 国家法律法规数据库首页为前端应用，MVP 使用回退解析，法规检索能力有限。
• search_tax_rate 返回的是官方依据和谨慎摘要，不构成税务意见。
• 税率适用需结合纳税人身份、地区、业务类型和执行期限，以官方原文及主管税务机关口径为准。