SanctionsKit developer MCP

SanctionsKit 插件

在编辑器中构建 SanctionsKit 集成。查找 API 文档、检查请求格式，并使用虚构主体进行沙盒测试。

此插件集成了托管的 SanctionsKit MCP 服务连接，以及适用于 Codex、Claude Code 和 Cursor 的集成技能。无需运行本地服务，也无需安装脚本。

独立的 Gemini CLI 扩展连接到四个公开的文档、架构和请求验证工具。它不需要 SanctionsKit 账户或 API 密钥，也不会开放沙盒账户工具。

文档 · MCP 指南 · 身份验证 · MIT 许可证

开始使用

克隆此仓库并打开其目录。按照下方对应客户端的说明安装，然后尝试：

查找 SanctionsKit 筛查请求架构，并验证一个虚构示例，但不要提交。

无需 SanctionsKit 账户即可使用文档、架构和请求验证功能。沙盒账户工具需要连接到 SanctionsKit 工作区。必须在托管服务上配置每个客户端的 OAuth 注册；请参阅身份验证设置。

连接到托管的 MCP 服务

你也可以使用 Streamable HTTP，直接通过以下地址连接到 MCP 客户端：

https://www.sanctionskit.com/mcp

公开的文档、架构和验证工具无需凭据。要使用沙盒账户工具，请先在 SanctionsKit 注册客户端 ID 和回调地址，然后通过客户端的 OAuth 连接流程登录。请求的范围为 sources:read、screenings:write、results:read 和 usage:read。有关客户端配置和验证状态，请参阅身份验证设置。

Codex

在仓库根目录中：

codex plugin marketplace add .

在 Codex 中打开插件目录，选择 SanctionsKit 市场，然后安装 SanctionsKit。安装后开始一项新任务。若通过 GitHub 安装，请将此仓库的 HTTPS GitHub URL 传给同一命令，而不是 .。

Claude Code

在仓库根目录中启动 Claude Code：

/plugin marketplace add .
/plugin install sanctionskit@sanctionskit

你也可以将此仓库的 HTTPS GitHub URL 传给 /plugin marketplace add。安装后重启 Claude Code。使用 /mcp 检查连接；需要使用账户工具时，请登录。

Cursor

若要本地安装，请在 Cursor 中启用 Allow Local Plugin Imports，将插件文件夹复制到其本地插件目录，然后重新加载 Cursor。企业策略可能要求管理员允许本地导入。

mkdir -p ~/.cursor/plugins/local
cp -R plugins/sanctionskit ~/.cursor/plugins/local/

此命令用于首次安装；更新时请替换现有的 sanctionskit 文件夹。请使用实际副本，因为 Cursor 会跳过外部符号链接目标。团队管理员可以在团队的插件市场中使用 Import from Repo，并填写此仓库的 GitHub URL。若要在 Cursor 公共目录中列出插件，需另行提交申请。

Gemini CLI

从此仓库安装扩展：

gemini extensions install https://github.com/SanctionsKit/sanctions-kit-mcp-plugin

重启 Gemini CLI，然后使用 /mcp 检查 sanctionskit 连接。试试：

查找 SanctionsKit 筛查请求架构，并验证一个虚构示例，但不要提交。

根目录中的 gemini-extension.json 使用 Streamable HTTP，且仅允许使用 search_docs、get_doc、get_api_schema 和 validate_screening_request。其中不包含凭据、OAuth 配置、本地可执行文件或捆绑的上下文文件。请求验证仅检查结构；不会提交筛查，也不会核查真实对象。Gemini CLI 自身的访问要求仍然适用。

沙盒筛查和其他账户工具不属于此扩展。为其他客户端捆绑的集成技能不会随 Gemini 扩展安装。如果你已在 Gemini 的 settings.json 中配置名为 sanctionskit 的服务，该配置将优先生效；如果要使用此扩展的公共工具配置，请将其移除或重命名。

你可以做什么

工具	用途	连接
search_docs	查找集成指南和文档标识	公共
get_doc	阅读已发布目录中的文档	公共
get_api_schema	查看 REST 操作、架构和示例	公共
validate_screening_request	检查请求结构，不提交请求	公共
list_sources	查看来源元数据和可用性	沙盒工作区
run_sandbox_screening	向 sandbox@1 提交虚构对象	沙盒工作区
get_screening_result	获取保留的沙盒证据	沙盒工作区
get_usage	检查沙盒额度和预留额度	沙盒工作区
get_profile	确认已连接的配置	沙盒工作区

捆绑的 sanctionskit-integration 技能涵盖请求设计、验证、错误处理、重试以及沙盒结果解读。它使用当前的工具架构和文档，而不会假定存在某个 SDK 或端点。

接下来可以试试：

• “说明如何将 SanctionsKit 筛查集成到我的服务端 TypeScript 应用中。”
• “验证一个针对虚构组织的 sandbox@1 请求。”
• “运行合成的 Alex Morgan 示例，然后显示结果和剩余的沙盒额度。”
• “说明超时后应如何重试请求。”

参见合成请求示例和 MCP 参数示例。

沙盒行为

MCP 账户工具在沙盒中运行。生产密钥会被拒绝。沙盒筛查会消耗沙盒额度，按照保留政策保留证据，并可能创建审核案例。每次新的筛查意图都应使用新的幂等键；重试未收到响应的请求时，需保持密钥和载荷不变。

验证仅检查结构。来源目录条目不会改变沙盒的合成覆盖范围。合成结果不能说明任何真实个人或组织的情况，无匹配结果也不代表已获得法律许可。生产集成应使用服务端 REST API，并遵循所在组织的审核流程。

故障排查

问题	检查内容
插件未显示	将仓库根目录添加为市场，安装插件，然后启动新会话。
invalid_client 或重定向错误	在身份验证设置中检查准确的客户端 ID 和已注册的回调地址。
登录或权限错误	使用所需的权限范围重新连接沙盒工作区。
端口已被占用	关闭使用该端口的其他登录流程，然后重试。
生产密钥被拒绝	MCP 使用沙盒连接；生产集成仍通过 REST API 进行。
结果已过期	报告过期情况；只有在确实要进行新一轮筛查时，才创建新的筛查。
覆盖范围或限额错误	检查返回的错误和当前沙盒用量。请勿在未告知的情况下切换覆盖范围。

开发

仅仓库检查需要 Node.js 22 或更高版本。没有 npm 依赖项。

npm ci
npm run check
npm run smoke

check 用于验证软件包结构并运行离线测试。smoke 用于检查公开托管的 MCP 端点及其身份验证质询，不会登录或创建筛查。smoke 检查通过并不代表客户端的交互式登录可以正常工作。

.agents/plugins/       Codex marketplace
.claude-plugin/        Claude Code marketplace
.cursor-plugin/        Cursor marketplace
gemini-extension.json  Gemini CLI public-tool extension
plugins/sanctionskit/  Installable plugin, client configs, skill, and assets
docs/                  Authentication and release guidance
scripts/               Package validation and public connection check
tests/                 Offline verification

有关更改的信息，请参阅 CONTRIBUTING.md；有关发布的信息，请参阅发布指南。

由 SanctionsKit, LLC 维护。如需帮助，请联系 [email protected]。本仓库采用 MIT 许可证；托管服务的使用受 SanctionsKit 条款和隐私政策约束。