SuperAPI AI 工具集

mcp-fssp

mcp-fssp 是面向俄罗斯债务人与合规检查的 MCP 服务器,用于查询个人、公司和个体经营者的执行程序(债务)信息。它通过统一接口连接多个商业数据提供商,让 AI 代理(如 Cursor、Claude Desktop)在对话中完成对俄罗斯交易对手的尽职调查,返回债务金额、状态、法警信息及追索依据。

访问官网

工具介绍

用途

mcp-fssp 是一个 MCP(Model Context Protocol)服务器,用于查询俄罗斯联邦法警局(ФССП)的强制执行程序信息,支持对个人、公司和个体经营者进行债务与合规检查。它作为 MCP 客户端(如 Cursor、Claude Desktop 及任何支持 MCP 的客户端)与商业数据提供商之间的中间层,让 AI 代理能够在对话中直接发起查询。

主要能力

  • 检查个人的执行程序(依据姓名全称 + 出生日期)。
  • 检查法人实体的执行程序(依据 ИНН-10 / ОГРН-13)。
  • 检查个体经营者(依据 ИНН-12 / ОГРНИП-15)。
  • 返回数据包括:债务金额、状态、法警信息及追索依据。
  • 支持多提供商接入:Damia、Checko、NewDB、api-cloud,并提供统一标准化数据模型。
  • 提供 MCP 工具调用接口,例如 fssp.check_individual_debts(...)、fssp.check_legal_entity_debts(...)、fssp.get_proceeding_details(...)。
  • 属于 atomno 系列 MCP 服务器的一部分,该系列用于对俄罗斯交易对手进行尽职调查(due-diligence),包括 mcp-egrul(法人注册信息)、mcp-fns-check(税务合规)、mcp-cbr-rates(央行汇率)等。

使用方式

  1. 获取至少一个提供商的 API 密钥:
    • Damia(https://api-fssp.damia.ru)—— 生产环境的主要候选,价格从 7 000 ₽/年起(1 000 次请求),提供 100 次免费测试请求。
    • Checko(https://api.checko.ru)—— 每天最多 50 次免费请求,适合入门。
    • NewDB(https://newdb.net/fssp/api)—— 经济替代方案,2 ₽/请求,100 次免费。
    • api-cloud(https://api-cloud.ru/api/fssp.php)—— 按请求付费。
  2. 在工作目录创建 .env 文件(或通过 MCP 配置传递环境变量),完整变量列表见 .env.example。
  3. 连接到 Cursor:打开 ~/.cursor/mcp.json(或 Settings → MCP)并添加配置,重启 Cursor 后 AI 代理即可调用工具。
  4. 连接到 Claude Desktop:打开 claude_desktop_config.json 并添加配置。

适用场景

  • AI 代理在 Cursor / Claude Desktop 中于 30 秒内完成交易对手尽调,替代手动访问 ФССП 网站约 10 分钟的过程。
  • 律师、银行、评分机构可将统一的 check_*_debts 调用集成到 Python 脚本或 1С 中,无需解析来自 3-4 个不同提供商的原始响应。
  • 自托管爱好者可使用自己的 Damia/Checko 密钥在本地运行客户端,避免依赖第三方 SaaS,降低个人数据泄露顾虑。

限制与注意事项

  • 官方 ФССП API(api-ip.fssp.gov.ru)自 2022 年 3 月 10 日起已停用且无恢复计划。唯一官方入口是带 CAPTCHA 的公共 Web 服务 fssp.gov.ru/iss/ip,因此本项目依赖商业提供商。
  • 个人数据(姓名、出生日期)不以明文保存;审计日志仅存储 sha256(fio_lower + birth_date)。
  • 根据 229-ФЗ 第 6.1 条,银行数据库中的执行程序信息属于公开信息,无需债务人同意即可获取。但商业使用需遵守 152-ФЗ,合法使用(如交易前尽调、经借款人同意的评分)由用户自行负责。
  • 本服务是 ФССП 公开数据的聚合器和便捷界面,与 ФССП 俄罗斯、Damia、Checko、NewDB、api-cloud 等提供商无关,使用风险自负。
  • 工具返回的信息仅供参考,不能替代 ФССП 出具的官方文件;作者不对提供商数据的时效性、完整性和准确性负责。
  • 做出法律意义上重要的决定(如拒绝贷款)时,必须向债务人本人或通过官方渠道(向法警部门请求)索取原始文件。

版本状态

  • v0.1(当前):Phase 0 脚手架 + Damia 提供商 + check_individual_debts。
  • v0.2:多提供商(+Checko、NewDB、api-cloud)、check_legal_entity_debts、get_proceeding_details、本地 L1 缓存。
  • v0.3+:通过 CAPTCHA-solver 的 self_parser。
  • v0.5:与 Pro 后端(api.atomno-mcp.ru/fssp/)集成:summarize_debts、monitor_debts_changes、30 天 L2 缓存、3 提供商回退。
  • Pro 后端(atomno-mcp/mcp-fssp-server)计划在 Phase 2 推出(私有托管服务,专有许可证)。开源客户端无需它即可完全运行,用户填入任意 4 个商业提供商的密钥即可。

许可证:MIT © 2026 atomno。