Mochi MCP服务器
A. 模型上下文协议 服务器，使AI代理（Claude、Codex等）能够管理您的 Mochi.卡 抽认卡。
特性
- 浏览 牌组和卡片
- 搜索 按内容或标签分类的卡片
- 创建/更新 两阶段提交的卡片（应用前预览）
- 删除 打印确认卡（安全第一）
- 强大的安全性 -默认情况下禁用甲板删除
快速开始
# Install
npm install
# Build
npm run build
# Run (needs your Mochi API key)
MOCHI_API_KEY=your_key_here node dist/index.js从Mochi应用程序获取API密钥：设置→ 账户→ API密钥。
使用Claude Desktop
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"mochi": {
"command": "node",
"args": ["/path/to/mochi-mcp/dist/index.js"],
"env": {
"MOCHI_API_KEY": "your_api_key"
}
}
}
}然后问克劳德：“列出我的Mochi牌组”或“搜索关于渐变的牌”。
工具
读取操作
| 工具 | 说明 |
|---|---|
list_decks | 列出所有甲板 |
get_deck | 获取卡片列表 |
get_card | 获取完整的卡内容 |
get_cards | 按ID获取多张卡 |
search_cards | 按文本、标签或日期搜索。返回丰富的结果（deckId、createdAt等） |
list_cards_page | 带书签的分页卡片列表 |
find_deck_by_name | 按名称查找甲板（不区分大小写的部分匹配） |
写操作（两阶段提交）
| 工具 | 说明 |
|---|---|
create_card_preview | 预览新卡→ 返回令牌 |
apply_create_card | 使用令牌应用创建 |
update_card_preview | 使用diff预览编辑→ 返回令牌 |
update_card_fields_preview | 预览问答编辑→ 返回令牌 |
apply_update_card | 使用令牌应用更新 |
update_cards_batch_preview | 预览批量更新 |
apply_update_cards_batch | 应用批量更新 |
标签操作（两阶段）
| 工具 | 说明 |
|---|---|
add_tags_preview | 预览向卡片添加标签 |
remove_tags_preview | 预览删除标签 |
apply_tags_update | 使用令牌应用标签更改 |
删除操作（需要确认）
| 工具 | 说明 |
|---|---|
delete_card | 软删除（要求：“删除卡片\”） |
delete_deck | 默认情况下已禁用 |
业绩说明
- 全局搜索 最多扫描 1000张卡片
- 每层搜索 最多扫描 5000张卡片
- 使用
list_cards_page对于较大的收藏，可以进行分页 - 日期过滤器使用 协调世界时 （ISO 8601格式：
YYYY-MM-DDTHH:mm:ss.sssZ)
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
MOCHI_API_KEY | ✅ | - | 您的Mochi API密钥 |
MOCHI_ALLOW_DECK_DELETE | ❌ | false | 启用甲板删除 |
MOCHI_TOKEN_EXPIRY_MINS | ❌ | 10 | 预览令牌有效性 |
安全设计
- 两阶段提交：创建/更新操作首先显示预览。您通过使用返回的令牌进行批准。
- 键入确认书：删除需要键入
"delete card "确切地。
- 甲板删除已禁用：必须设置
MOCHI_ALLOW_DECK_DELETE=true以启用。
- 软删除默认值：卡片被丢弃（可在Mochi应用程序中恢复）。
发展
# Run tests
npm test
# Type check
npm run lint
# Development mode
MOCHI_API_KEY=your_key npm run dev
# Test with MCP Inspector
npm run inspect许可证
麻省理工学院