FINOS MCP - AI Governance (community)

finos-mcp

让 AI 助手能够准确查阅三项金融行业开放标准，且无法对其进行任何更改。

从一个问题开始

你想做什么	选择此服务	查看示例
查找 AI 治理风险和控制措施，并获取可追溯的参考资料	AIGF	治理示例
了解交易字段或验证 CDM JSON	CDM	CDM 示例
为金融工具找到合适的桌面 intent	FDC3	FDC3 示例

官方 MCP 注册表（已发布 v0.3.2）： AIGF · CDM · FDC3。 这三个都是本地 stdio软件包，而非公开托管的端点。

**Claude Code 快速连接：**安装 Claude Code 和 uv 后，针对所需标准运行以下 命令之一：

claude mcp add --scope user finos-aigf -- uvx --python 3.12 finos-mcp-aigf==0.3.2
claude mcp add --scope user finos-cdm -- uvx --python 3.12 finos-mcp-cdm==0.3.2
claude mcp add --scope user finos-fdc3 -- uvx --python 3.12 finos-mcp-fdc3==0.3.2

运行 claude mcp list，然后让你的助手使用 get_control （AIGF）、describe_type（CDM）或 suggest_intent（FDC3）。 客户端设置指南还提供经过测试的 Claude Desktop、VS Code 和 Copilot JSON 配置示例， 并包含针对 Windows 和 macOS 的故障排除说明。

如需在没有模型或 API 密钥的情况下查看真实的 MCP 调用，请克隆此仓库， 运行 uv sync --all-packages，然后尝试：

uv run --no-sync python examples/try_it.py aigf

请在经过测试的示例配方中选择另外两个服务之一。 这是独立的社区软件，并非 FINOS 官方产品。

这是什么？

银行和其他金融公司共享一系列由 FINOS（金融科技开源基金会）发布的开放标准。其中有三个与此项目相关：

• AI Governance Framework，列出了在金融领域使用 AI 的风险，以及可降低这些风险的 控制措施；
• Common Domain Model (CDM)，一种描述交易及其后续变化的通用方式；
• FDC3，让金融桌面应用彼此通信的标准。

当有人向 AI 助手询问这些标准时，助手通常会凭记忆作答，从而提供错误细节： 不存在的 ID、不在架构中的字段。这个项目为助手提供可查询的真实信息。 它将每项标准打包成一个小型服务，通过 Model Context Protocol（MCP）这一开放协议进行通信， Claude 和其他助手借助该协议调用外部工具。

连接这些服务后，助手就能回答这类问题：

• “哪些控制措施可以降低提示词注入风险？它们与欧盟 AI 法案中的哪些内容对应？”
• “这份交易 JSON 符合 CDM 吗？如果不符合，具体错在哪里？”
• “我的应用中选中了一个股票代码。我可以向用户提供哪些 FDC3 操作？”

每个答案都附带一个标识符或链接，读者可以据此对照标准原文进行核查。

三个服务

服务	标准	助手可以用它做什么
finos-mcp-aigf	AI Governance Framework	按已发布的 ID 查找 24 项风险和 25 项控制措施，查看哪些控制措施针对哪些风险，交叉参照 13 个外部框架（NIST、ISO 42001、欧盟 AI 法案、OWASP），并使用自然语言搜索
finos-mcp-cdm	Common Domain Model	探索 767 种 CDM 类型和 1,143 个 JSON 架构，浏览产品和交易事件，并通过精确的错误路径验证交易文档
finos-mcp-fdc3	FDC3	查找 19 项标准操作（“意图”）和 28 种数据类型，检查数据对象，并建议适用于该对象的操作

这三个服务都基于 finos-mcp-core，这是一个共享软件包，其中包含下文介绍的安全规则。 docs/tools.md 列出了全部 29 个工具；docs/demo.md 展示了一次真实会话，其中 CDM 服务找出了交易文档中故意设置的三个错误。

快速开始

你只需要 uv，无需其他工具。无需注册账户、设置 API 密钥或数据库。

首次设置： 按照 MCP 客户端设置指南操作，其中提供了可直接复制粘贴且固定版本的 Claude Desktop、Claude Code、 VS Code 和 GitHub Copilot 配置。指南还介绍了 Windows 和 macOS 的设置、如何验证实际工具调用，以及故障排除。下面的快速入门示例固定使用已发布并经过端到端测试的 v0.3.2 软件包。

Claude Desktop 或 Claude Code。 将以下内容添加到 MCP 配置中 （完整示例），然后重启：

{
  "mcpServers": {
    "finos-aigf": { "command": "uvx", "args": ["--python", "3.12", "finos-mcp-aigf==0.3.2"] }
  }
}

通过命令行运行。

# talk over stdin/stdout, the way desktop assistants connect
uvx --python 3.12 finos-mcp-aigf==0.3.2

# or serve HTTP on localhost (self-hosted, not a public hosted service)
uvx --python 3.12 finos-mcp-aigf==0.3.2 --transport streamable-http --port 8000

作为容器运行。 无需可写磁盘，也无需额外权限：

docker run --rm -p 8000:8000 --read-only --cap-drop ALL \
  -e FINOS_MCP_ALLOWED_HOSTS='localhost:*,127.0.0.1:*' \
  ghcr.io/vardhjain/finos-mcp:v0.3.2

允许的主机设置会使服务拒绝来自其他主机名的请求，从而阻止浏览器中的网页访问该端口。

直接运行 stdio 命令会启动一个等待客户端连接的服务； 它不会显示聊天提示词。要在终端中验证安装，请改用 --help。 将 finos-mcp-aigf 替换为 finos-mcp-cdm 或 finos-mcp-fdc3 即可运行其他服务。 examples/ 中包含一个低内存、可复现的实时演示、 一个简短的 Python 客户端，以及一个 LangGraph Agent。

为什么连接是安全的

为助手提供新工具存在风险，因此这些服务受到刻意限制：

• 只能读取。 没有任何工具会写入文件、发送消息或更改任何系统。如果有工具未标记为只读，服务就会拒绝提供任何工具。
• 可以离线运行。 标准内容会在构建时复制到软件包中，并记录确切的上游版本。服务运行期间不会获取任何内容。
• 不会遭到洪泛。 每个工具都有速率限制，以及输入和输出大小上限。
• 会说明错误。 请求无效时会返回结构化错误，指出问题所在及可尝试的做法，让助手能够自行纠正，而不是猜测。
• 所有操作都会记录。 每次调用都会写入审计日志，并以参数指纹代替原始内容。

所有详细信息（包括每项设置）均见 docs/safety.md。

有一项可选功能确实会使用网络。安装 semantic 扩展后会启用基于语义的搜索，该功能会在首次使用时下载一个小型开源模型。不安装该扩展时，搜索基于关键词且完全离线。

效果如何

这些数据由自动化检查测得，并发布在 metrics 分支上。上方的徽章会直接读取该文件，因此显示的是特定提交的数据。

检查项	结果
自动化测试	通过 200 多项测试，代码覆盖率超过 90%。具体数据见上方徽章
根据自然语言问题查找正确记录（50 个问题）	91.5% 的情况下，正确答案位于前五项中
AI 模型通过服务回答 20 个治理问题	未编造任何 ID；95% 的回答引用了有效 ID
每次工具调用的响应时间	在基准测试的工具上为几毫秒

离线指标会在每次推送到 main 时更新；本表中的搜索结果来自 2026 年 10 月。Agent 测试使用 Claude Haiku 4.5，并需要付费的 Anthropic API 额度。为避免意外产生费用，该测试仅在 GitHub Actions 中明确手动选择后运行，不会按计划或因 PR 标签触发。已发布的数据来自 2026 年 9 月 14 日最近一次成功评估，并非实时数据。不调用 LLM API 的确定性测试和检索评估会继续在 CI 中运行。

构建此项目还发现了上游标准中的 15 个缺陷，记录在 docs/upstream-findings.md 中。第一个缺陷已报告给 FINOS，其 YAML 修复已于 2026 年 10 月 21 日通过 PR #380 合并到上游。

项目结构

路径	内容
core/	共享安全层：只读强制执行、速率限制、大小上限、审计日志、搜索
servers/	每项标准对应一个软件包，各自包含上游内容副本
evals/	黄金测试、AIGF 检索、离线 CDM/FDC3 工作流、延迟和可选的 Agent 评估
examples/	配置和客户端示例
docs/	文档，也发布于 https://vardhjain.github.io/finos-mcp/

开发

uv sync --all-packages --all-extras
uv run pytest
uv run pytest evals/offline/test_workflows.py -v  # 16 multi-tool scenarios, no paid APIs
uv run ruff check . && uv run mypy core/src servers/*/src

请参阅 CONTRIBUTING.md 了解基本规则，参阅 CHANGELOG.md 了解各版本的变更，参阅 RELEASING.md 了解发布流程，并参阅 PLAN.md 查看原始设计记录。

状态

对于维护者，MCP 目录和 Registry 状态 记录了 3 个已发布的官方 Registry 条目，以及待处理的 Glama 列表更正。 未来提交到第三方目录需要单独审批。

最新发布版本可在 PyPI 上获取，包名为 finos-mcp-core、 finos-mcp-aigf、 finos-mcp-cdm 和 finos-mcp-fdc3，支持 Python 3.12 及更高版本；也可通过容器镜像获取，支持 x86 和 ARM。

**与 FINOS 无关联，也未获其认可。**这些是独立的社区软件包。PyPI 上也有一些以 finos- 开头的 FINOS 官方软件包；本文中的软件包均不属于其中任何一个。

许可证

代码采用 Apache-2.0 许可证。复制的标准保留各自的许可证：AI Governance Framework 采用 CC-BY-4.0 许可证，CDM 和 FDC3 采用 Community Specification License 1.0。 请参阅 NOTICE。