注册UZ MCP服务器
斯洛伐克财政部为斯洛伐克财务报表登记处(Registerúčtovnýchávierok)提供的模型上下文协议(MCP)服务器,基于 API文档.
作者 @阿尔哈福
特性
- API全面覆盖:RegisterUZ Open API的所有终结点
- Pydantic模型:所有API实体的完全类型化响应模型
- 25个MCP工具:使用带标签的表搜索、列出、检索和分析财务数据
- 8 MCP资源:静态分类器数据和动态实体查找
- 20个MCP提示:为常见集成场景预先构建的工作流程
- CLI客户端:用于测试和勘探的命令行工具
可用数据
- 会计单位 (účtovnéjednotky):公司/组织详细信息,包括IČO、DIČ、地址、法律形式
- 会计结算 财务报表元数据和期间
- 财务报告 (财务报表):资产负债表,收入报表,全数据表
- 年度报告 年度报告元数据和附件
- 模板 (Šablóny):报告结构定义
- 分类器:法律形式、SK NACE代码、地区、地区、定居点
快速入门(托管版)
将托管的MCP服务器添加到您的Claude集成中:
Claude代码集成(托管)
claude mcp add registeruz --transport http https://registeruz.fastmcp.app/mcp
Claude桌面集成(托管)
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"registeruz": {
"type": "streamable-http",
"url": "https://registeruz.fastmcp.app/mcp"
}
}
}
Make.com集成(托管)
您可以在中使用Autoform MCP服务器 Make.com (前身为Integromat)使用 MCP客户端-调用工具 应用程序:
- 添加 MCP客户端-调用工具 模块到您的场景
- 使用以下设置创建新的MCP服务器连接:
- 统一资源定位符: https://registeruz.fastmcp.app/mcp - API密钥/访问令牌:留空(不需要身份验证)
- 选择要调用的工具并配置查询参数
______________________________________________________________________
自托管安装
来自PyPI(推荐)
pip install registeruz-mcp
或者使用uvx直接运行而无需安装:
uvx registeruz-mcp
来源
# Clone the repository
git clone https://github.com/alhafoudh/registeruz-mcp.git
cd registeruz-mcp
# Install dependencies
uv sync
用法
运行MCP服务器(STDIO传输)
# If installed from PyPI
registeruz-mcp
# Or using uvx
uvx registeruz-mcp
# Or from source
uv run python registeruz_mcp.py
使用FastMCP CLI运行
uv run fastmcp run registeruz_mcp.py
检查可用工具
uv run fastmcp inspect registeruz_mcp.py
MCP Inspector开发模式
uv run fastmcp dev registeruz_mcp.py
可用工具
列出工具(获取ID)
| 工具 | 说明 |
|---|
get_uctovne_jednotky | 获取自日期以来更改的会计单位ID(支持按IČO、DIČ、法律形式过滤) |
get_uctovne_zavierky | 获取自某个日期以来更改的会计结算ID |
get_uctovne_vykazy | 获取自某个日期以来更改的财务报告ID |
get_vyrocne_spravy | 获取自某个日期以来更改的年度报告ID |
计数工具(分页)
| 工具 | 说明 |
|---|
get_zostavajuce_id_uctovne_jednotky | 统计剩余的会计单位ID |
get_zostavajuce_id_uctovne_zavierky | 统计剩余的会计结算ID |
get_zostavajuce_id_uctovne_vykazy | 统计剩余的财务报告ID |
get_zostavajuce_id_vyrocne_spravy | 统计剩余的年度报告ID |
详细工具
| 工具 | 说明 |
|---|
get_uctovna_jednotka | 按ID获取会计单位详细信息 |
get_uctovna_zavierka | 按ID获取会计结算详细信息 |
get_uctovny_vykaz | 获取包含表格和数据的财务报告 |
get_vyrocna_sprava | 按ID获取年度报告详细信息 |
模板工具
| 工具 | 说明 |
|---|
get_sablona | 按ID获取模板结构 |
get_sablony | 获取所有可用模板 |
分类器工具
| 工具 | 说明 |
|---|
get_pravne_formy | 获取所有合法表格 |
get_sk_nace | 获取SK NACE分类代码 |
get_druhy_vlastnictva | 获取所有权类型 |
get_velkosti_organizacie | 获取组织规模 |
get_kraje | 获取斯洛伐克地区 |
get_okresy | 获取斯洛伐克地区 |
get_sidla | 获得斯洛伐克定居点 |
下载工具
| 工具 | 说明 |
|---|
get_attachment_url | 获取附件的下载URL |
get_financial_report_pdf_url | 获取财务报告的PDF下载URL |
标记数据工具
| 工具 | 说明 |
|---|
get_uctovny_vykaz_with_labeled_tables | 获取带有标签表的财务报告(在一次调用中将报告与模板标签组合在一起) |
get_uctovny_vykaz_table_value_by_labels | 按行标签、行代码、列标签或表名搜索特定值 |
可用资源
静态资源(分类器)
| URI | 描述 |
|---|
ruz://classifiers/pravne-formy | 法律形式 |
ruz://classifiers/sk-nace | SK NACE代码 |
ruz://classifiers/druhy-vlastnictva | 所有权类型 |
ruz://classifiers/velkosti-organizacie | 组织规模 |
ruz://classifiers/kraje | 地区 |
ruz://classifiers/okresy | 地区 |
ruz://classifiers/sidla | 定居点 |
ruz://templates | 所有模板 |
动态资源模板
| URI模式 | 描述 |
|---|
ruz://uctovna-jednotka/{id} | 按ID列出的会计单位 |
ruz://uctovna-zavierka/{id} | 按ID结账 |
ruz://uctovny-vykaz/{id} | 按ID列出的财务报告 |
ruz://vyrocna-sprava/{id} | ID年度报告 |
ruz://sablona/{id} | 按ID模板 |
可用提示
公司搜索提示
| 提示 | 描述 |
|---|
search_company_by_ico | 按IČO搜索公司并获取财务报表 |
search_company_by_dic | 按税号(DIČ)搜索公司 |
search_companies_by_legal_form | 按法律形式搜索公司(例如s.r.o.、a.s.) |
财务分析提示
| 提示 | 描述 |
|---|
get_latest_financials | 获取公司的最新财务报表 |
compare_financials_year_over_year | 比较公司多年的财务状况 |
extract_financial_metrics | 提取具体的财务指标(利润、资产、负债) |
get_balance_sheet | 获取公司的资产负债表(Súvaha)数据 |
get_income_statement | Get income statement (收益和损失表) for a company |
变更跟踪和监控提示
| 提示 | 描述 |
|---|
analyze_changes | 分析一段时间内会计单位的变化 |
monitor_new_filings | 监控自某一日期以来提交的新财务报表 |
track_company_changes | 跟踪特定公司最近的变化 |
文档和下载提示
| 提示 | 描述 |
|---|
get_company_documents | 获取公司的所有可下载文档 |
get_annual_reports | Download annual reports (年度报告) for a company |
模板和结构提示
| 提示 | 描述 |
|---|
explore_template | 探索财务报告模板结构 |
list_all_templates | 列出所有可用的报告模板及其用途 |
分类器和参考数据提示
| 提示 | 描述 |
|---|
get_location_hierarchy | 获取斯洛伐克所有地区和地区等级 |
get_legal_forms_explained | 获取所有附有解释的法律表格 |
explore_sk_nace | 探索SK NACE行业分类代码 |
散装/出口提示
| 提示 | 描述 |
|---|
bulk_export_companies | 导出多个公司的基础数据 |
generate_financial_summary | 生成全面的公司财务汇总报告 |
Claude代码集成(自托管)
使用uvx(推荐)
直接从PyPI运行服务器,无需安装:
claude mcp add registeruz -- uvx registeruz-mcp
使用本地安装
如果您已经克隆了存储库:
claude mcp add registeruz -- uv run --directory /path/to/registeruz-mcp python registeruz_mcp.py
Claude桌面集成(自托管)
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
使用uvx(推荐)
{
"mcpServers": {
"registeruz": {
"command": "uvx",
"args": ["registeruz-mcp"]
}
}
}
使用本地安装
{
"mcpServers": {
"registeruz": {
"command": "uv",
"args": ["run", "--directory", "/path/to/registeruz-mcp", "python", "registeruz_mcp.py"]
}
}
}
发展
安装开发依赖项
uv sync --all-extras
运行测试
uv run pytest -v
许可证
麻省理工学院