用途
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(央行汇率)等。
使用方式
- 获取至少一个提供商的 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)—— 按请求付费。
- 在工作目录创建
.env文件(或通过 MCP 配置传递环境变量),完整变量列表见.env.example。 - 连接到 Cursor:打开
~/.cursor/mcp.json(或 Settings → MCP)并添加配置,重启 Cursor 后 AI 代理即可调用工具。 - 连接到 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。