内容
# 6DuckLearn MCP
官方公共设置文档、注册表元数据和用于托管的 6DuckLearn MCP 服务器的本地连接器包。
在 Codex 或 Claude Code 中使用 `6ducklearn` 作为本地客户端密钥。官方 MCP 注册表名称为 `com.6ducklearn/mcp`，托管端点为：
```text
https://6ducklearn.com/mcp
```
本仓库故意托管优先。它不包含私有 6DuckLearn SaaS 后端、Supabase 边缘函数、服务角色数据库访问、计费逻辑、用户内存存储或生产部署脚本。
## 快速入门
### Codex
从 GitHub：
```bash
npx github:kit18/6ducklearn-mcp setup-codex
```
这会在本地 Codex 中配置托管的 6DuckLearn MCP 服务器，添加托管的 OAuth 兼容性标头，并启动 OAuth 登录流程。
如果已经存在 `6ducklearn` 条目，则设置命令会首先刷新它，以便旧的本地或 stdio 桥接设置不会保留。
手动回退：
```bash
codex mcp remove 6ducklearn # 如果不存在则忽略
codex mcp add 6ducklearn --url https://6ducklearn.com/mcp
codex mcp login 6ducklearn --scopes mcp:read,mcp:write,runtime:connect,control:read,control:write,policy:read,approval:request,approval:decide
```
如果您手动配置 Codex，并且托管边缘挑战 OAuth 发现，请在登录前将以下块添加到 `~/.codex/config.toml`：
```toml
[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"
```
### Claude Code
```bash
claude mcp add --transport http 6ducklearn https://6ducklearn.com/mcp
```
然后在 Claude Code 中打开 MCP 工具选择器，并在提示时授权 6DuckLearn。
### npm 包状态
`@6ducklearn/mcp` 和 `@6ducklearn/connector` npm 包尚未发布。在 npm 发布可用之前，请使用上面的 GitHub `npx` 命令进行复制和粘贴设置。
## 托管 MCP 身份
- 本地客户端密钥：`6ducklearn`
- MCP 注册表名称：`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 OAuth 捆绑包，以便同意页面可以提供较低的权限级别。用户可以在 OAuth 期间批准较小的集合，而 6DuckLearn 角色/付费层级上限可以阻止不可用的范围。可写入和敏感操作仍然由 6DuckLearn 运行时策略和用户批准控制。
## 代理可以执行的操作
6DuckLearn MCP 为连接的代理提供账户授权的工作流，用于研究、组织、提醒、投资组合审查、知识检索、画布创建和技能构建器发现。
有关完整的公共目录，请参阅 [MCP 工具用例](./docs/tool-use-cases.md)。该目录通过实际用例和示例提示描述每个工具，而不暴露私有模式或后端实现细节。
与财务相关的功能仅用于研究、组织、摘要、警报和用户授权的工作流。6DuckLearn MCP 不是订单路由服务或投资建议的来源。
## 高级：本地运行时连接器
连接器适用于希望在 6DuckLearn 和本地代理（如 Codex、OpenClaw 或 Hermes）之间建立本地运行时桥接的用户。首选设置路径是从 6DuckLearn 网页进行 OAuth。
```bash
npm install
npm run build
SIXDUCK_PUBLIC_BASE_URL=https://6ducklearn.com node packages/connector/dist/index.js login
```
登录后，在使用本地运行时保持连接器进程运行：
```bash
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 注册表发布
官方注册表清单位于 [`server.json`](./server.json)。它是一个仅托管的列表，因为规范的 6DuckLearn MCP 服务器运行在 `https://6ducklearn.com/mcp`；本地连接器是一个运行时桥接器，而不是一个独立的 stdio MCP 服务器包。
在发布之前，验证清单和托管端点：
```bash
npm run validate:registry
npm run smoke:hosted
```
使用基于域的身份验证发布，以便注册表名称可以保留在 6DuckLearn 域命名空间下：
```bash
# 在生成证明密钥并提供 /.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 注册表列出 `com.6ducklearn/mcp` 后，通过电子邮件发送 `partnerships@github.com` 请求 GitHub MCP 注册表收录，附上注册表名称、官方注册表 URL、GitHub 仓库、网站、托管端点和验证证据。GitHub 的 MCP 注册表是一个单独的精选表面，因此在那里列出目前需要 GitHub 审查，而不是依赖自动社区注册表同步。
## 公开内容
- 托管的 MCP 设置说明
- 官方 MCP 注册表清单
- 净化客户端示例
- 本地连接器源代码和测试
- 实时托管端点烟雾检查
- 防止私有 SaaS 详细信息进入此公共仓库的机密扫描
## 私有内容
- 6DuckLearn SaaS 应用程序源代码
- 生产 Supabase 函数和迁移
- 服务角色数据库模式
- 用户内存、PKM、计费、批准轨迹和运行时健康数据
- 内部发布脚本和生产部署凭证
## 开发
```bash
npm install
npm run validate
```
验证运行 TypeScript 构建、连接器测试、包干运行、MCP 注册表清单检查、托管 MCP 烟雾检查和公共发布机密扫描。
## 安全
私下报告安全问题。请参阅 [SECURITY.md](./SECURITY.md)。
## 许可证
代码在 Apache-2.0 下获得许可。文档示例在 CC BY 4.0 下获得许可。请参阅 [TRADEMARK.md](./TRADEMARK.md) 以获取 6DuckLearn 品牌使用信息。
