税法mcp
取得日本税法、通知、裁决事例的MCP服务器。
当Claude回答税务问题时防止条文和通知的春电影中描述的场景,使用下列步骤创建明细表,以便在概念设计中分析体量的周长。
特徴
- 法令取得 —通过Markdown格式从e-Gov法令API v2获取条文
- 法令検索 —通过关键字搜索法规
- 通达取得 —国税厅网站截屏基本通知、措施法通知(17通知对应)
- 通达目次 —列出通知的章节结构
- 裁决事例 —国税不服审判所(kfs.go.jp)の公表裁决事例1,950件を検索・取得
- Shift_JIS対応 —支持国税厅、国税不服裁判所网站的文字编码
- 主要税法预设 —将所得税法、法人税法、消费税法、措施法等law_id硬编码
- 略称対応 — 「所法」「措法」「所基通」「措通(譲渡)」等の略称で指定可能
MCP工具
工具|说明| |---|---| | get_law 从e-Gov法令API取得条文。用法令名称+条编号指定| | search_law 用关键字搜索法令 | get_tsutatsu 从国税厅网站取得通知。通达名+通达号码指定 | list_tsutatsu 查看通知目录 | list_saiketsu 查看裁决案例的税目、类别一览表 | search_saiketsu 用关键字搜索裁决事例(1950件起) | get_saiketsu 取得裁决事例的全文
适用法令(预设)
所得税法、法人税法、消費税法、相続税法、租税特別措置法、国税通則法、国税徴収法、各施行令・施行規則 等(24法令)
对应通达(17通达)
基本通达
| 通达名 | 略称 |
|---|---|
| 所得税基本通达 | 所基通 |
| 法人税基本通达 | 法基通 |
| 消费税法基本通达 | 消基通 |
| 相続税法基本通达 | 相基通 |
| 财产评似基本通达 | 评基通 |
| 连接纳税基本通达 | — |
| 国税通则法基本通达 | 通法基通 |
| 印纸税法基本通达 | 印基通 |
| 税理士法基本通达 | 税理士通达 |
| 国税徴収法基本通達 | 徴基通 |
| 酒税法基本通达 | 酒基通 |
措置法通达
| 通达名 | 略称 |
|---|---|
| 措置法通达(山林所得・譲渡所得关系) | 措通(譲渡) |
| 措置法通达(申告所得税关系) | 措通(申告) |
| 措置法通达(法人税编) | 措通(法人税) |
| 措置法通达(相続税关系) | 措通(相続税) |
| 措置法通达(源泉所得税关系) | 措通(源泉) |
| 措置法通达(株式等譲渡所得等关系) | 措通(株式) |
安装,安装
npx(推奨)
无需安装。仅复制以下设置:
{
"mcpServers": {
"tax-law": {
"command": "npx",
"args": ["-y", "tax-law-mcp"]
}
}
}克劳德桌面版: ~/Library/Application Support/Claude/claude_desktop_config.json 添加到
克劳德代码: claude mcp add tax-law -- npx -y tax-law-mcp
本地(源)
git clone https://github.com/kentaroajisaka/tax-law-mcp.git
cd tax-law-mcp
npm install
npm run build{
"mcpServers": {
"tax-law": {
"command": "node",
"args": ["/path/to/tax-law-mcp/dist/index.js"]
}
}
}远程(Vercel)
⚠️ 注意:当前Claude的远程MCP连接(自定义连接)存在已知故障,可能无法正常运行。为了稳定使用,建议在npx(本地)设置。
部署到您自己的验证程序后,您的团队成员可以无需安装:
vercel deploy{
"mcpServers": {
"tax-law": {
"url": "https://.vercel.app/mcp"
}
}
}REST API(版本0.4.0〜)
除了MCP外,还提供REST API端点。自定义GPT(ChatGPT)的ActionsGemini、可以从其他AI工具中使用。
端点列表
|端点|说明| |---|---| | GET /api/get-law | 条文取得(law_name, article 必须)| | GET /api/search-law | 法令検索(keyword 必须)| | GET /api/get-tsutatsu |通达取得(tsutatsu_name, number 必须)| | GET /api/list-tsutatsu |通达目次(tsutatsu_name 必须)| | GET /api/list-saiketsu |裁决税目一览表(无参数或 tax_type) | | GET /api/search-saiketsu |裁决検索(keyword 必须)| | GET /api/get-saiketsu |裁决全文(url 或 collection_no+case_no) |
使用例
# 所得税法第33条を取得
curl "https:///api/get-law?law_name=所得税法&article=33"
# キーワードで法令検索
curl "https:///api/search-law?keyword=インボイス"
# 通達を取得
curl "https:///api/get-tsutatsu?tsutatsu_name=所基通&number=33-6"用于自定义GPT
- 部署到验证(
vercel deploy) openapi.yaml的,之servers.url将重新写入部署到URL- 自定义GPT的“Actions”→“Schema”
openapi.yaml粘贴内容 - 向GPT询问“请告诉我所得税法33条”,在API中取得条文并有根据地回答
OpenAPI仕样书
openapi.yaml 中所述修改相应参数的值。在Custom GPT的Actions和Swagger UI中可以直接使用。
用法示例(MCP)
条文的取得
“取得所得税法第33条”
→ get_law(law_name="所得税法", article="33")
取得通知
“取得所得税基本通知33-6”
→ get_tsutatsu(tsutatsu_name="所基通", number="33-6")
措施法通知的取得
“取得措施法通知(转让)的33-8”
→ get_tsutatsu(tsutatsu_name="措通(譲渡)", number="33-8")
查找裁决案例
“寻找有关重加税的裁决事例”
→ search_saiketsu(keyword="重加算税")
裁决事例的全文取得
“想读裁决事例集第139集的1号”
→ get_saiketsu(collection_no=139, case_no=1)
税目别の裁决事例一覧
“给我看一下所得税相关裁决事例的类别”
→ list_saiketsu(tax_type="所得税")
春景防止工作流
- Claude为税务问题创建临时答复
- 引用的条文和通知
get_law/get_tsutatsu获得 - 对照实际原文和临时回答,如有错误则修正
- 重复2-3直到收敛(最多4轮)
裁决事例(v0.3.0〜)
可以检索并取得国税不服裁判所(kfs.go.jp)的公开裁决事例(97册・1950件)。
対応税目(13税目)
国税通则法关系、所得税法关系、法人税法关系、相続税法关系、消费税法关系、地似税法关系、登録免许税法关系、印纸税法关系、挥発油税法关系、自动车重量税法关系、国税征收法关系、租税特别措置法关系、たばこ税法关系
搜索机制
- 筛选事例集目录页(97册),从摘要文本中检索关键字
- 第一次获得所有页面(30-60秒),之后使用高速缓存(TTL1小时)
latest也可以用参数将搜索范围缩小到最新N册
出典
通知的利用国税厅ー利用中所述修改相应参数的值。
参考
- 塔库罗/伊戈夫法律 —参考XML→Markdown转换、工具设计
- e-Gov法令API v2 — API仕様
许可证
麻省理工学院
