Mochi MCP Server (Shunkus)

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