kabuken

Kabuken — 面向 Claude 和 ChatGPT 的 EDINET MCP 服务

Kabuken 是一个 EDINET MCP 服务。它为 Claude、ChatGPT 及其他 MCP 客户端提供日本上市公司的财务报表、分部明细和主要股东信息，数据取自这些公司 在 EDINET 提交的官方文件。每个数值都附有来源文件和对应期间。将客户端连接到 https://kabuken.intellics.ai/mcp。Kabuken 会返回单项 XBRL 事实，包含英文和日文分类标准标签以及计算链接库树。 Kabuken 不提供股价或投资建议。

Kabuken は EDINET MCP サーバーです。Claude、ChatGPT などの MCP クライアントから、 日本の上場企業が EDINET に提出した書類の財務諸表、セグメント情報、大株主を 取得できます。各数値には出典となる提出書類と対象期間を示します。接続先は https://kabuken.intellics.ai/mcp です。株価や投資助言は提供しません。

EDINET MCP 指南：English · 日本語

需要注册。在 kabuken.intellics.ai 获取账户和 kbk_ API 密钥（或使用 OAuth）。

Kabuken 提供的内容

• 每个数值均附来源文件和期间。 每个数值都会注明其来源的 EDINET 文件及所涵盖的期间，方便你对照原始文件进行核查。
• 计算树。 get_calculation_tree 会以树状结构返回文件的 XBRL 计算 链接库，让你查看总额如何拆分为各组成部分及其权重。
• 分部明细。 get_segment_breakdown 会按维度轴和成员返回业务、 地理区域及合并范围的数值。
• 主要股东。 get_major_shareholders 会返回持有人、持股 比例及报告日期，数据来自大额持股报告（大量保有報告書）。
• Claude 和 ChatGPT 的 OAuth 登录。 Claude 和 ChatGPT 通过 OAuth 登录连接，无需复制 API 密钥。不支持 OAuth 的 MCP 客户端可以 使用 API 密钥连接。
• 技能包。 本仓库是 Claude Code 插件，也是面向 ChatGPT 和 Codex 的插件 包，包含常见任务的技能（公司概览、同业比较、分部明细）。

安装

此插件会在 .mcp.json 中声明一个远程 MCP 服务 （https://kabuken.intellics.ai/mcp，可流式传输的 HTTP）。启用插件， 然后参阅 SETUP.md，或询问 Claude“设置 Kabuken”以 完成身份验证。

未安装插件的 Claude Code：

claude mcp add --transport http kabuken https://kabuken.intellics.ai/mcp

ChatGPT（开发者模式，测试版）

1. 下载最新的插件包： kabuken-plugin.zip。
2. 打开 chatgpt.com/plugins，选择 +，然后 选择 Create custom MCP server。
3. 上传 ZIP 文件。
4. ChatGPT 提示连接 Kabuken 时，使用 Google 登录。

同一仓库也提供面向 ChatGPT 和 Codex 的 Agent 插件包：根目录中的 plugin.json 和 mcp.json。Claude Code 会读取 .claude-plugin/plugin.json 和 .mcp.json。请参阅 插件包。

工具

按用途分组的只读工具。不会写入或修改数据。

公司与行业发现

• search_companies — 按名称搜索日本上市公司（EN 或 JA，部分匹配）
• get_company — 根据任意标识符（实体代码、股票代码、名称）获取完整公司记录
• list_industries — TSE 行业分类体系（双语）

申报文件

• list_documents — 公司在 EDINET 的申报文件列表，包含提交日期、涵盖期间以及 XBRL/PDF 可用性

财务数据

• get_financial_facts — 单份申报文件的结构化 XBRL 数据，标签为双语
• get_calculation_tree — 以树形结构展示 XBRL 计算链接库（总额如何分解为各组成部分）
• get_segment_breakdown — 分部／地理区域／合并范围维度数据，轴和成员标签为双语
• get_company_financials — 多期损益表、资产负债表和现金流量表，按报表类型分组

比较与筛选

• compare_companies — 根据最新年度证券报告，为 2-5 家公司生成并排财务矩阵
• screen_companies — 按财务比率（ROE、ROA、营业利润率、流动比率、债务权益比）筛选公司；不支持基于价格的筛选
• get_industry_overview — 提供某行业各比率的均值／中位数／数量，以及排名前 3 和后 3 的公司

所有权与风险

• get_major_shareholders — 大量持股报告数据：持有人、持股比例、股份数量、申报日期
• get_risk_context — 公司对 BOJ 政策利率的敏感度，以及 METI 出口管制分类

AI 驱动的分析

• get_document_summary — AI 生成的申报文件摘要
• analyze_document — 基于特定申报文件的自由文本问答

账户

• get_account_quota — 调用者当前每日配额的使用量、限额和重置时间；此工具本身不会消耗配额

账户

在 kabuken.intellics.ai 获取账户和 kbk_ API 密钥（或使用 OAuth）。连接步骤请参阅 SETUP.md。

斜杠命令

• /kabuken:company-snapshot <company> — 单家公司的收入、利润、资产、权益和风险背景
• /kabuken:peer-comparison <company, company, ...> — 并排比较 2-5 家公司的财务数据
• /kabuken:segment-breakdown <company> — 申报文件中的业务／地理分部明细

署名

EDINET 内容（申报文件、数据、维度）依据日本《公共数据许可 1.0》（PDL 1.0）使用：

来源：EDINET（https://disclosure2.edinet-fsa.go.jp/），PDL 1.0 （https://www.digital.go.jp/resources/open_data/public_data_license_v1.0）。 数据由 Kabuken 处理，并非未经处理的 FSA 原始数据。

EDINET Taxonomy（概念标签、计算链接库关系、维度轴／成员标签）不属于 PDL 1.0 范围，另依据 FSA EDINET Taxonomy 法律声明 （https://www.fsa.go.jp/search/EDINET_Taxonomy_Legal_Statement.html）授权；该声明要求在再分发时附上以下声明：“© Copyright 2014 Financial Services Agency, The Japanese Government”。展示分类体系内容的工具（get_calculation_tree、get_segment_breakdown）均附有此声明。

screen_companies、get_industry_overview、compare_companies 和 get_company_financials 返回的数字由 Kabuken 根据 EDINET 申报文件计算得出，并非 EDINET 直接报告的数据。analyze_document 的输出由 AI 生成，可能包含错误；不构成投资建议。

隐私政策

https://kabuken.intellics.ai/privacy

文档

https://kabuken.intellics.ai/docs

插件包

scripts/build-package.sh 会构建 dist/kabuken-plugin-<version>.zip，ZIP 根目录包含 plugin.json，此外还包含 mcp.json、skills/（不含仅供 Claude Code 使用的 kabuken-setup 技能）、assets/ 和 LICENSE。 不会打包 README.md。scripts/validate-package.sh 会检查清单、技能、README 和 SETUP.md，scripts/tests/run-tests.sh 会测试这些检查。 Plugin package 工作流会在每次向 main 提交拉取请求或推送时运行，并在推送 v* 标签时将 ZIP 附加到 GitHub 版本发布中。 标签必须与 plugin.json 中的 version 一致。

版本管理

一个版本号同时适用于 Claude 插件（.claude-plugin/plugin.json）、 ChatGPT/Codex 包（plugin.json）和 MCP Registry 条目（server.json）。如果这三个版本号不一致，scripts/validate-package.sh 会失败。 要发布：将这三个版本号都更新为相同的 X.Y.Z，合并到 main，推送标签 vX.Y.Z，然后从该标签手动运行 Publish to MCP Registry 工作流。只有在已检出的提交中存在标签 v<server.json version> 时，工作流才会发布。

Registry 清单

server.json 按照 官方 MCP Registry 格式描述托管的 Kabuken MCP 服务（https://kabuken.intellics.ai/mcp），并从此仓库以 io.github.intellics-ai/kabuken 命名空间发布。服务自身的源代码位于单独的私有仓库中；此公开仓库是 Registry 的配套条目，也是上文所述插件包的所在仓库。通过 .github/workflows/publish-registry.yml 执行发布（手动 workflow_dispatch、GitHub OIDC 身份验证、不存储密钥）。