快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

🏦 税务顾问MCP服务器

全面 模型上下文协议（MCP） 服务器通过Claude Desktop提供智能多国税务协助。功能包括税务计算、截止日期跟踪、知识缓存、自动提醒和自主国家发现。

✨ 特性

🌍 多国支持（新增！）

基于术语表的体系结构 拥有54个以上的通用税收概念
荷兰已全面实施 （方框1/2/3，BTW，2024年费率）
自主国家探索 通过 add_country 工具
可扩展框架 添加新国家
看多国指南 详情

📊 核心能力

11 MCP工具 用于税务计算、搜索、建议和国家设置
11 MCP资源 暴露税务数据和知识
3内置提示 用于常见的税务工作流程
国家不可知接口 为未来扩展

🧠 知识缓存系统

缓存首次搜索 获取即时答案
自动网页抓取 来自荷兰官方税务网站
到期管理 具有可配置的刷新功能
Git跟踪 用于版本控制
智能相关性评分 搜索结果

🔔 自动提醒

纳税截止日期通知 （所得税、BTW等）
定期付款跟踪 （保险、订阅）
电报集成 安静的时光
自动知识更新 （每周，可配置）
税法变更监测 （每周检查）

🧮 税务计算

方框1：所得税，包括所有扣除和抵免
方框2：巨额利息税
方框3：视为回报的财富税
顺便提一下：个体经营者的增值税计算
情景规划 用于假设分析

🚀 快速开始

先决条件

Node.js 18+和npm
Claude Desktop（用于MCP集成）
可选：电报机器人（用于通知）

安装

# Clone the repository
git clone https://github.com/yourusername/tax-adviser-mcp.git
cd tax-adviser-mcp

# Install dependencies
npm install

# Run setup wizard
npm run setup

# Build the project
npm run build

# Start the MCP server
npm start

Claude桌面集成

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "tax-adviser": {
      "command": "node",
      "args": ["/absolute/path/to/tax-adviser-mcp/dist/index.js"]
    }
  }
}

重新启动克劳德桌面，服务器将可用！

📚 文档

设置.md -详细的设置和配置指南
API毫米 -完整的工具和资源参考
建筑.md -系统架构概述
MULTI_COUNTRY.md ⭐ - 多国支持指南（新增！）

🛠️ 可用工具

工具	说明
`get_tax_obligations`	在截止日期前获取所有适用的纳税义务
`get_upcoming_dues`	跟踪定期计划中即将到来的付款
`send_reminder`	发送带有日程安排的电报通知
`calculate_tax_estimate`	综合税务计算（方框1/2/3，荷兰BTW）
`search_dutch_tax_law`	缓存首次网络搜索税法
`search_knowledge_base`	搜索本地知识缓存
`get_knowledge_entry`	按ID检索完整的知识条目
`refresh_knowledge`	手动刷新缓存条目
`get_law_changes`	检测不同年份之间的税法变化
`get_spending_advice`	个性化财务优化建议
`add_country` ⭐	自主发现和建立新的国家支持

📦 可用资源

资源URI	描述
`personal://profile`	您的个人税务档案
`tax://calendar/{year}`	含重要日期的税务日历
`tax://rates/{year}`	特定年份的税率
`tax://deductions/{year}`	可用扣除额
`tax://rules`	完整的税务规章制度
`knowledge://base`	知识缓存索引
`knowledge://stats`	缓存统计信息
`knowledge://categories`	按类别分类的条目
`knowledge://recent`	最近缓存的条目
`knowledge://expired`	需要刷新的过期条目

🤖 后台守护程序

守护进程运行计划任务以实现自动化：

# Start the daemon
npm run daemon:start

# Stop the daemon
npm run daemon:stop

# Check daemon status
npm run daemon:status

计划的作业

每天上午9点：税务截止日期提醒
每天上午10点：到期付款提醒
周日凌晨3点：知识缓存刷新
周一上午8点：税法变更监测

🔧 实用程序脚本

# Knowledge management
npm run knowledge:stats    # View cache statistics
npm run knowledge:refresh  # Refresh expired entries

# Configuration
npm run validate           # Validate configuration
npm run setup              # Re-run setup wizard

# Testing
npm test                   # Run all tests
npm run test:watch         # Run tests in watch mode
npm run test:coverage      # Generate coverage report

⚙️ 配置

配置通过以下方式管理 data/config.yaml.关键部分：

# Enable/disable features
telegram:
  enabled: true
  bot_token: "your-bot-token"
  chat_id: "your-chat-id"

# Knowledge cache settings
knowledge:
  enabled: true
  auto_cache: true
  refresh_strategy: weekly
  default_expiry_days: 90

# Tax year
tax:
  year: 2024
  country: NL

# Reminder schedule
reminders:
  enabled: true
  deadline_check_time: "0 9 * * *"  # Daily at 9 AM

看 data/config.example.yaml 所有80+配置选项。

📝 个人资料

您的个人税务信息存储在 data/personal.md:

---
name: Your Name
date_of_birth: 1990-01-01
bsn: 123456789
---

## Income
- Employment: €60,000/year
- Freelance: €30,000/year (registered, BTW number: NL123...)

## Assets
- Savings: €50,000
- Investments: €30,000
- Mortgage: €250,000

## Recurring Payments
| Name | Amount | Frequency | Auto-pay |
|------|--------|-----------|----------|
| Health Insurance | €150 | Monthly | Yes |
| BTW Quarterly | €2,000 | Quarterly | No |

看 data/personal.example.md 一个完整的模板。

🧪 测试

# Run all tests
npm test

# Watch mode
npm run test:watch

# Coverage report
npm run test:coverage

# Specific test file
npm test knowledge-cache

📊 知识缓存

知识缓存会随着时间的推移而学习和改进：

# View statistics
npm run knowledge:stats

# Sample output:
# ═══════════════════════════════════════
#   OVERVIEW
# ═══════════════════════════════════════
#   Total Entries:        47
#   Storage Size:         156 KB
#
# ═══════════════════════════════════════
#   BY CATEGORY
# ═══════════════════════════════════════
#   box3                 12 (25.5%)
#   self_employment      8 (17.0%)
#   income_tax           7 (14.9%)

🔒 隐私和安全

本地优先：本地存储在计算机上的所有数据
无云同步：个人数据永远不会离开您的计算机
Git跟踪：知识缓存的可选版本控制
加密通讯：Telegram使用端到端加密
开源：完全透明，自己审核代码

🤝 贡献

欢迎投稿！请阅读贡献.md 第一。

开发设置

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run linter
npm run lint

# Format code
npm run format

# Type checking
npm run type-check

📄 许可证

MIT许可证-请参阅许可证了解详情。

🙏 致谢

内置于模型上下文协议
使用荷兰官方税务数据税务服务
由克劳德（Anthropic）提供技术支持

🆘 支持

问题:
讨论:
电子邮件: support@example.com

🗺️ 路线图

\[\]第11阶段：多国支持（美国、英国、德国等）
\[\]用于配置的Web界面
\[\]将税务报告导出为PDF格式
\[\]与荷兰税务机关整合API
\[\]用于提醒的移动应用程序
\[\]基于人工智能的税务优化建议

⚠️ 免责声明

本软件仅供参考，不构成专业税务建议。根据您的具体情况，始终咨询合格的税务顾问或会计师。开发人员不对基于此软件做出的任何财务决策负责。

______________________________________________________________________

由...制作❤️ 荷兰税务界

目录标签

TypeScriptClaude云端部署税务计算本地部署多国税务支持知识缓存自动提醒税务咨询

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

token

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明token部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/e116af5f32fbbebceeec7fa44aa407d5

一个提供多国税务智能辅助的Model Context Protocol (MCP)服务器，支持税务计算、截止日期跟踪、知识缓存、自动提醒和自主国家发现等功能。

继续浏览同类 MCP

更多运维云端 MCP（13,854）返回 MCP 目录

上一个 MCP

Tavily MCP Loadbalancer

一个专为Tavily MCP服务器设计的负载均衡器，管理API密钥池并实现故障转移，适用于高可用性和可扩展的API流量管理。

下一个 MCP

Taxes MCP Server

在Cloudflare Workers上部署无需认证的远程MCP服务器，支持本地MCP客户端连接。

Tax Adviser MCP