6DuckLearn MCP

6DuckLearn MCP

6DuckLearn 集成的官方公开配置文档、注册表元数据和本地连接器包。

此仓库包含两个独立的集成：托管 MCP 让 Codex 使用 6DuckLearn 工具；AI Runtime Connector 让 Agent Console 将任务发送给 Codex、Hermes 或 OpenClaw。

在 Codex 或 Claude Code 中使用 6ducklearn 作为本地客户端键。官方 MCP Registry 名称为 com.6ducklearn/mcp，托管端点为：

https://6ducklearn.com/mcp

此仓库有意采用托管优先的方式。它不包含 6DuckLearn 私有 SaaS 后端、Supabase edge functions、服务角色数据库访问权限、计费逻辑、用户记忆存储或生产部署脚本。

快速开始

Codex

从 GitHub 配置：

npx github:kit18/6ducklearn-mcp setup-codex

此命令会在本地 Codex 中配置托管的 6DuckLearn MCP 服务，添加托管 OAuth 兼容性标头，并启动 OAuth 登录流程。 如果已存在匹配且已通过身份验证的 6ducklearn 托管条目，配置命令会保留该条目，不会重新启动 OAuth。其他本地条目或 stdio 条目会被替换；匹配但未登录的条目则会继续 OAuth 流程，因此重复执行配置仍会保持确定性，且不会产生重复项。

手动备用方案：

此备用方案不要使用 codex mcp add：当前版本的 Codex 可能会在显式提供作用域之前，通过该命令立即启动 OAuth。先使用 codex mcp get 6ducklearn --json 检查条目：

• 如果条目不存在，请将下面的完整代码块添加到 ~/.codex/config.toml。
• 如果条目已使用下面的 URL，请保留其服务表，并仅添加缺失的 http_headers 表。
• 如果条目使用了其他 URL 或传输方式，请运行 codex mcp remove 6ducklearn，然后添加完整代码块。

[mcp_servers.6ducklearn]
url = "https://6ducklearn.com/mcp"

[mcp_servers.6ducklearn.http_headers]
User-Agent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125 Safari/537.36"

仅启动显式指定作用域的登录流程：

codex mcp login 6ducklearn --scopes mcp:read,mcp:write,approval:request

Claude Code

claude mcp add --transport http 6ducklearn https://6ducklearn.com/mcp

然后在 Claude Code 中打开 MCP 工具选择器，并在收到提示时授权 6DuckLearn。

npm 包状态

npm 包 @6ducklearn/mcp 和 @6ducklearn/connector 尚未发布。在 npm 发布可用之前，请使用上面的 GitHub npx 命令进行复制粘贴配置。

托管 MCP 身份信息

• 本地客户端键：6ducklearn
• MCP Registry 名称：com.6ducklearn/mcp
• 标题：6DuckLearn MCP
• MCP URL：https://6ducklearn.com/mcp
• OAuth 发现端点：https://6ducklearn.com/.well-known/oauth-authorization-server
• 受保护资源元数据：https://6ducklearn.com/.well-known/oauth-protected-resource/mcp

公开的 Codex 辅助程序仅请求 mcp:read、mcp:write 和 approval:request。控制平面访问和本地运行时授权使用单独且明确命名的流程；托管 MCP 配置绝不会请求 approval:decide。受保护的写入操作会提交到 6DuckLearn Inbox，并附带由服务端签发的审批 ID。用户在 Inbox 中进行决定，然后 Codex 只需调用 resume_approved_write 并提供该 ID，即可执行一次已锁定的请求。

Agent 可以做什么

6DuckLearn MCP 为已连接的 Agent 提供经账户授权的工作流，用于研究、整理、提醒、投资组合审查、知识检索、画布创建和 Skill Builder 探索。启用这些功能的已连接账户还可使用金融研究功能，包括范围受限的股票研究套件和基于发行方信息的香港信用卡评估。

完整的公开目录请参阅 MCP 工具使用场景。目录按实际使用场景和提示词示例介绍每个工具，不会暴露私有架构或后端实现细节。

金融相关功能用于研究、整理、摘要、提醒和经用户授权的工作流。6DuckLearn MCP 不是订单路由服务，也不提供投资建议来源。

金融研究示例

如果你想通过一次只读响应获取可用的价值、时间、事件、风险、已保存研究和投资组合输入，请请求股票信息包：

Build a 90-day cached research bundle for 0700.HK. Include upcoming dates for the next 90 days, identify stale or missing evidence, and do not give trading instructions.

对于香港信用卡，请将证据查询与评估分开：

First show the published dining-card evidence and freshness. Then evaluate annual net value for HKD 8,000 of monthly dining spend, excluding welcome offers and disclosing every missing or unverified field.

query_credit_card_catalog 不会对信用卡进行排名。recommend_credit_cards 仅评估当前已发布且附有来源链接的目录；它可能返回有限、过时或数据不足状态，而不是选出优胜者。缺失的标准化字段仍需披露；不得以此为由捏造奖励比率、资格条件、费用或排名证据。

高级用法：AI Runtime Connector

此连接器适用于希望在 6DuckLearn 与 Codex、OpenClaw 或 Hermes 等 AI 运行时之间搭建本地运行时桥接的用户。推荐通过 6DuckLearn Web 应用使用 OAuth 完成设置。

npm install
npm run build
SIXDUCK_PUBLIC_BASE_URL=https://6ducklearn.com node packages/connector/dist/index.js login

登录后，使用本地运行时时请保持连接器进程运行：

SIXDUCK_RUNTIME_TYPE=codex \
SIXDUCK_CODEX_CWD=/absolute/path/to/your/workspace \
SIXDUCK_CODEX_QUIET_PROFILE=true \
node packages/connector/dist/index.js

大多数用户应从托管版 6DuckLearn 设置页面开始，而不是直接克隆此代码库。

发布到 MCP Registry

官方 Registry 清单位于 server.json。这是仅托管版的条目，因为规范的 6DuckLearn MCP 服务运行于 https://6ducklearn.com/mcp；本地连接器是运行时桥接，而不是独立的 stdio MCP 服务包。

发布前，请验证清单和托管端点：

npm run validate:registry
npm run smoke:hosted

请使用基于域名的身份验证进行发布，以便将 Registry 名称保留在 6DuckLearn 域名命名空间下：

# After generating the proof key and serving /.well-known/mcp-registry-auth:
mcp-publisher login http --domain 6ducklearn.com --algorithm ecdsap384 --private-key "$PRIVATE_KEY"
mcp-publisher publish
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.6ducklearn/mcp"

所需的 HTTP 证明必须由 https://6ducklearn.com/.well-known/mcp-registry-auth 提供。官方 MCP Registry 收录 com.6ducklearn/mcp 后，请发送电子邮件至 [email protected]，提供 Registry 名称、官方 Registry URL、GitHub 代码库、网站、托管端点和验证证据，以申请收录到 GitHub MCP Registry。GitHub 的 MCP Registry 是单独审核的精选目录，因此目前需要经过 GitHub 审核才能收录，而不能依赖自动社区 Registry 同步。

此处公开的内容

• 托管版 MCP 设置说明
• 官方 MCP Registry 清单
• 已脱敏的客户端示例
• 本地连接器源代码和测试
• 托管端点的实时冒烟测试
• 防止私有 SaaS 详情进入此公开代码库的机密扫描

保持私有的内容

• 6DuckLearn SaaS 应用源代码
• 生产环境 Supabase 函数和迁移
• 服务角色数据库模式
• 用户记忆、PKM、账单、审批记录和运行时健康数据
• 内部发布脚本和生产部署凭证

开发

npm install
npm run validate

验证流程会运行 TypeScript 构建、连接器测试、软件包试运行、MCP Registry 清单检查、托管 MCP 冒烟测试和公开发布机密扫描。

安全

请私下报告安全问题。请参阅 SECURITY.md。

许可证

代码采用 Apache-2.0 许可。文档示例采用 CC BY 4.0 许可。6DuckLearn 品牌使用方式请参阅 TRADEMARK.md。