comdirect

comdirect-mcp

用于 comdirect REST API 的只读 MCP 服务和类型化 Python 客户端。 让 Claude、GitHub Copilot 或本地模型查看你的账户、交易、证券账户和邮箱。你在 photoTAN 应用中批准登录，任何工具都无法转账。

警告

非官方项目，与 comdirect 无关。它会处理你的银行凭据，每个工具的结果都会发送给 MCP 客户端背后的模型：如果使用云端助手，你的财务数据就会离开你的电脑。为了最大限度地保护隐私，请使用本地模型。请参阅 SECURITY.md。

警告（用德语，因为 comdirect）

各位，这里涉及的是你们的钱。只有在理解代码并了解风险时才使用。MIT 许可证：任何人都可以随意使用（comdirect 也一样 👀），但不提供任何保证，也不承担任何责任。

透明说明：部分代码来自 Opus 5.5 和 gpt-6.1-sol；我进行了审查、测试，并点头认可。正因如此：要理解代码。

服务只使用只读端点，但仍可能出错：comdirect 可能会更改 API，依赖项可能遭到入侵，双重身份验证也不是万无一失。因此：

• 只在自己的电脑上本地使用，不要把凭据交给任何人。
• 将凭据保存在操作系统的钥匙串中（comdirect-mcp configure）。.env 文件会以明文保存密码：绝不要提交。
• 不要盲目安装更新：固定版本，并查看变更。

MCP 服务：如果将它连接到云端客户端，你的数据就会离开你的电脑，并可能出现在日志中。交易用途和文件可能包含提示词注入。因此，只在你信任的环境中使用。

如果你本来就会把银行对账单复制到 ChatGPT：随你，但风险自负！

功能

• 安全登录：在客户端确认推送 TAN；连续 5 次未确认挑战后，在 comdirect 锁定账户前停止；退出登录和关闭时撤销会话
• 凭据存储在操作系统密钥链中，只读工具带有准确的注释
• 在服务端提供答案：按月、交易对手或你自己的类别统计现金流和支出，显示订阅及其年度费用、投资组合配置
• 数据整洁：不将你自己账户之间的转账计入支出，PayPal 付款会显示商户，清理付款文本，屏蔽 IBAN
• 为你自己的脚本提供类型化 Python 客户端

API 仅返回最近 180 天的账户交易记录。

工具
login / logout	开始会话（推送 TAN）/ 结束会话并撤销会话
list_accounts, list_cards, get_wealth_overview	账户、银行卡及所有产品的余额
list_transactions	单笔交易
summarize_transactions	按月、交易对手、类型或类别统计收入、支出和净额
find_recurring_payments	订阅、合同和定期转账
list_depots, get_depot_positions, summarize_portfolio	投资账户持仓和配置
list_depot_transactions, list_orders, get_order, get_instrument	证券变动、订单簿、证券数据
list_documents, read_document	以文本或 PDF 格式查看邮筒文件（阅读后会标记为已读）

提示词：monthly_review、find_subscriptions、tax_documents。详情：工具参考。

快速开始

你需要 uv、comdirect API 访问权限 （Client ID 和 Secret）以及设为默认 TAN 方式的 photoTAN Push。

uvx [email protected] configure   # stores your credentials in the OS keychain

将服务添加到你的客户端，例如 Claude Code：

claude mcp add --transport stdio --scope user comdirect -- uvx [email protected]

也可以添加到 Claude Desktop、LM Studio 等客户端：

{
  "mcpServers": {
    "comdirect": {
      "command": "uvx",
      "args": ["[email protected]"]
    }
  }
}

然后提问，例如：„我在付哪些订阅？每年要花多少钱？“ 助手会调用 login，你只需在应用中批准推送。 VS Code、Ollama 等：配置 MCP 客户端 · 分步指南：入门 · 问题排查：故障排除。

Python 库

from comdirect_mcp import ComdirectClient
from comdirect_mcp.utils import default_push_tan_callback

client = ComdirectClient(
    {"client_id": "...", "client_secret": "...", "username": "...", "password": "..."},
    {"push_tan_cb": default_push_tan_callback},
)
client.login()  # approve the push TAN, then press Enter
for account in client.list_accounts():
    print(account.id, account.balance, account.currency)

请参阅使用 Python 库。

更多内容

文档 · CHANGELOG · CONTRIBUTING · 面向 AI 编码 Agent 的 AGENTS.md · MIT 许可证