闪卡管理服务

Mochi MCP Server是一个基于AI的闪卡创建和管理服务,支持HTTP/SSE和stdio两种模式,适用于学习记忆和知识管理场景。

  • by shunkus
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 shunkus/mochi-mcp-server

使用说明

Mochi MCP服务器

用于通过AI创建和管理Mochi卡抽认卡的MCP服务器。

支持两者 HTTP/SSE (用于Vercel部署)和 标准 (供Claude Desktop本地使用)。

特性

卡操作

  • create_card -创建新卡
  • get_card -获取卡详细信息
  • list_cards -列出卡片
  • update_card -更新卡片
  • delete_card -删除卡片
  • add_attachment -向卡片添加附件
  • delete_attachment -删除附件
  • create_cards_bulk -一次创建多张卡

甲板操作

  • create_deck -创建新甲板
  • get_deck -获取甲板详细信息
  • list_decks -列出所有甲板
  • update_deck -更新甲板
  • delete_deck -删除甲板

模板操作

  • create_template -创建新模板
  • get_template -获取模板详细信息
  • list_templates -列出所有模板

审查

  • get_due_cards -获取到期待审核的卡片

部署

部署到Vercel

  1. 单击上面的部署按钮
  2. 设置 MOCHI_API_KEY 环境变量
  3. 部署

API终点

  • GET / -服务器信息页面
  • POST /api/mcp -MCP JSON-RPC端点
  • GET /api/mcp/sse -流连接的SSE端点
  • POST /api/mcp/sse -SSE消息端点

示例请求

curl -X POST https://your-domain.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "x-mochi-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

本地开发

安装

npm install

开发服务器

npm run dev

构建

npm run build

标准模式(克劳德桌面)

对于Claude Desktop的本地使用,请使用stdio传输:

构建stdio版本

npm run build:stdio

Claude桌面配置

添加以下内容 ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mochi": {
      "command": "node",
      "args": ["/path/to/mochi-mcp-server/dist/stdio.js"],
      "env": {
        "MOCHI_API_KEY": "your-api-key-here"
      }
    }
  }
}

获取Mochi API密钥

  1. 登录 Mochi卡
  2. 转到帐户设置→ API获取API密钥

用法

创建卡片

卡片内容为Markdown格式。使用 --- 将正面和背面分开:

What is the capital of France?
---
Paris

批量卡创建

{
  "method": "tools/call",
  "params": {
    "name": "create_cards_bulk",
    "arguments": {
      "deck_id": "deck-id",
      "cards": [
        { "content": "Question 1\n---\nAnswer 1" },
        { "content": "Question 2\n---\nAnswer 2", "tags": ["tag1", "tag2"] }
      ]
    }
  }
}

备注

  • Mochi API每个账户只接受一个并发请求
  • 注意速率限制(429错误)
  • 甲板删除无法撤消

许可证

ISC