mcp-fssp

mcp-fssp

ФССП MCP 服务：查询个人、公司和个体经营者的执行案件——金额、状态、执法人员信息和追偿依据。可连接 Cursor、Claude 和任何 MCP 客户端。

面向 AI Agent 的俄罗斯司法执行债务查询工具。

支持：

• 自然人（通过姓名和出生日期）。
• 法人（通过 INN-10 / OGRN-13）。
• 个体经营者（通过 INN-12 / OGRNIP-15）。

这是用于俄罗斯交易对手尽职调查的 atomno MCP 服务系列之一： mcp-egrul（法人详细信息）· mcp-fns-check（税务合规性）· mcp-cbr-rates（央行汇率）· mcp-fssp（司法执行债务）。

为什么需要

俄罗斯联邦司法执行局的官方 API（api-ip.fssp.gov.ru）已于 2022 年 3 月 10 日停用，且暂无恢复计划。唯一的官方渠道是带 CAPTCHA 的公开 Web 服务 fssp.gov.ru/iss/ip。这带来了一个机会：提供支持多个商业服务商（Damia / Checko / NewDB / api-cloud）的 MCP 封装，以及标准化的数据模型。

主要使用场景：

• Cursor / Claude Desktop 中的 AI Agent 可在聊天中用 30 秒完成交易对手尽职调查，而无需花 10 分钟手动浏览司法执行局网站。
• 律师 / 银行 / 评分服务 可将统一的 check_*_debts 调用集成到 Python 脚本或 1С 中，无需解析 3-4 家不同服务商的原始响应。
• 可自托管爱好者可在本地安装客户端并使用自己的 Damia / Checko 密钥，无需依赖第三方 SaaS——消除对个人数据泄露的担忧。

快速开始

1. 安装

# Через pipx (рекомендуется для CLI):
pipx install atomno-mcp-fssp

# Или через uv (быстрее):
uvx atomno-mcp-fssp

# Или классически через pip:
pip install atomno-mcp-fssp

2. 获取服务商密钥

至少选择一家：

• Damia（https://api-fssp.damia.ru）— 生产环境首选。从每年 7 000 ₽ 起，可查询 1 000 次；提供 100 次免费测试查询。
• Checko（https://api.checko.ru）— 每天最多免费查询 50 次。适合 onboarding。
• NewDB（https://newdb.net/fssp/api）— 经济型替代方案，每次查询 2 ₽，提供 100 次免费查询。
• api-cloud（https://api-cloud.ru/api/fssp.php）— 按查询次数付费。

3. 配置

在工作目录中创建 .env（或通过 MCP 配置传入环境变量）：

MCP_FSSP_PROVIDER=damia
MCP_FSSP_DAMIA_KEY=ваш_ключ_от_Damia

完整变量列表请参阅 .env.example。

4. 连接到 Cursor

打开 ~/.cursor/mcp.json（或 Settings → MCP）并添加：

{
  "mcpServers": {
    "fssp": {
      "command": "uvx",
      "args": ["atomno-mcp-fssp"],
      "env": {
        "MCP_FSSP_PROVIDER": "damia",
        "MCP_FSSP_DAMIA_KEY": "ваш_ключ"
      }
    }
  }
}

重启 Cursor。现在，AI Agent 可以调用 fssp.check_individual_debts(...)、fssp.check_legal_entity_debts(...) 和 fssp.get_proceeding_details(...)。

5. 连接到 Claude Desktop

打开 claude_desktop_config.json 并添加：

{
  "mcpServers": {
    "fssp": {
      "command": "uvx",
      "args": ["atomno-mcp-fssp"],
      "env": {
        "MCP_FSSP_PROVIDER": "damia",
        "MCP_FSSP_DAMIA_KEY": "ваш_ключ"
      }
    }
  }
}

可用工具

工具	用途
ping	检查服务是否就绪以及当前服务商。
check_individual_debts(fio, birth_date, region?)	查询个人名下未结案的执行案件。
check_legal_entity_debts(inn?, ogrn?)	查询法人或个体经营者名下未结案的执行案件。
get_proceeding_details(proceeding_id)	按编号获取单个执行案件的详细信息。

Pro 版（Phase 3+，需要 ATOMNO_API_KEY）：

• summarize_debts(...) — 通过分类和风险评分生成债务 AI 摘要。
• monitor_debts_changes(...) — 订阅变更并通过 webhook / Telegram 接收提醒。

环境变量

变量	用途	默认值
MCP_FSSP_PROVIDER	服务提供商：damia / checko / newdb / api_cloud / self_parser / atomno_pro	damia
MCP_FSSP_DAMIA_KEY	Damia API-ФССП 密钥	—
MCP_FSSP_CHECKO_KEY	Checko v2 密钥	—
MCP_FSSP_NEWDB_KEY	NewDB 密钥	—
MCP_FSSP_API_CLOUD_KEY	api-cloud.ru 密钥	—
ATOMNO_API_KEY	Pro 模式密钥（api.atomno-mcp.ru/fssp/）	—
ATOMNO_API_BASE	Pro 后端 URL	https://api.atomno-mcp.ru/mcp-fssp/v1
MCP_FSSP_HTTP_TIMEOUT	单次请求的超时时间（秒）	15
MCP_FSSP_RPS	客户端每分钟请求数限制	30
MCP_FSSP_USER_AGENT	请求使用的 User-Agent	mcp-fssp/0.1 (...)
MCP_FSSP_AUDIT_DB	SQLite 审计日志路径	./audit.sqlite
MCP_FSSP_LOG_LEVEL	日志级别：DEBUG/INFO/WARNING/ERROR	INFO

安全与个人数据

• 个人数据（姓名、出生日期）不会以纯文本形式保存。审计日志仅存储 sha256(fio_lower + birth_date)。
• 根据 229-ФЗ 第 6.1 条，执行程序数据库中的信息属于公开信息，无需债务人同意即可访问。
• 尽管如此，出于商业目的使用时，运营方必须遵守 152-ФЗ。是否用于合法目的（例如，交易前尽职调查、经借款人同意后进行信用评分），由用户自行负责。

免责声明

本服务是基于公开的 ФССП 数据构建的聚合器和便捷接口（229-ФЗ 第 6.1 条）。与俄罗斯 ФССП、Damia、Checko、NewDB、api-cloud 及其他服务提供商均无关联。使用风险由您自行承担。

工具返回的信息仅供参考，不能替代 ФССП 出具的官方文件。作者不对服务提供商数据的时效性、完整性和准确性负责。使用信息的合法性（包括处理个人数据时遵守 152-ФЗ）由用户负责。

在作出具有法律效力的决定时（例如，拒绝发放贷款），必须向债务人本人索取原始文件，或通过官方渠道（向执行官部门提出请求）获取。

路线图

• 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 个服务提供商进行回退。

工具和环境变量文档见本 README 和 CHANGELOG.md。发布后也会在 GitHub 上提供：atomno-mcp/mcp-fssp。

许可证

MIT © 2026 atomno。

Pro 后端（atomno-mcp/mcp-fssp-server）— 计划在 Phase 2 推出（采用专有许可证的私有托管服务）。开源客户端无需该后端即可完整运行——用户可自行配置任意一家商业服务提供商的密钥（共 4 家）。

链接

• ФССП API 规范（历史版本）：api-ip.fssp.gov.ru（自 10.03.2022 起已停用）。
• ФССП Web 服务：fssp.gov.ru/iss/ip。
• MCP 目录：glama.ai/mcp/servers。
• MCP 规范：modelcontextprotocol.io。