咪咪 MCP 接入指南

1概述

咪咪 MCP 当前暴露 8 个学术 pipeline 工具，以及 2 个正式可调用的免费 helper 工具：search_kb 和 get_workflow_pack。前者是 hosted knowledge search，后者用于获取本地执行所需的工作流包。

2快速开始

最短路径是：获取 API key → 列出工具 → 调用工具。若你只想做本地工作流执行，优先使用 get_workflow_pack。若你要零登录纯本地模式，请直接安装下文的 Local Skills。

第一步：获取 API Key

在 MCP 控制台 登录后创建 key。默认 key 包含 catalog.read、tools.list、tools.call、pipelines、mcp.read、status.read。包括免费 helper 工具在内，所有 Hosted MCP 远程接口都需要 API key；纯本地 Skills 不需要登录。

第二步：列出工具

curl -s -X POST https://miwrite.art/api/mcp/remote/rpc \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

第三步：调用工具

curl -s -X POST https://miwrite.art/api/mcp/remote/rpc \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "run_lit_review_pipeline",
      "arguments": {
        "input_text": "Your literature text here...",
        "topic": "Research topic"
      }
    }
  }'

3接口列表

以下路径相对 https://miwrite.art。无认证接口标记为公开。

4工具参考

以下定义实时读取自 /api/mcp/catalog，避免文档与实现漂移。Pipeline 是托管模型工作流；helper 则包含免费 helper 工具和 catalog-only 目录项。

Pipeline 工具

Helper 工具

5知识库

咪咪的知识库是一套不断补充的研究内容集合。它不是一个下载区，而是把常用的方法、判断标准、术语说明和例子整理成稳定的内容底座，方便在不同任务里重复使用。

当前包含什么

• 研究方法：材料整理、资料分析、文献综述、文本精读、稿件评阅、报告模式、研究设计压力测试。
• 质量标准：不同任务的 rubric、证据判断、问题分级和修改优先级。
• 辅助内容：术语说明、写作风格、精选例子、常见反例。

当前状态

• 目前已经整理出 37 份可复用内容，后续会继续补。
• 这些内容会随着任务需要持续扩充，不是一版写完就封存。
• 知识库的目标不是替你提供材料证据，而是帮助你更稳地读材料、做判断、组织输出。

6示例输出

托管 pipeline 和免费 helper 工具使用不同的成功载荷，但都遵循统一的 `ok/error_code/message` 约束。

{
  "ok": true,
  "tool": "run_lit_review_pipeline",
  "request_id": "mcp_req_xxx",
  "workflow": "literature",
  "report_markdown": "## 文献综述...",
  "usage": { "totals": { "tokens_in": 1200, "tokens_out": 800 } }
}

{
  "ok": true,
  "tool": "get_workflow_pack",
  "target_tool": "run_lit_review_pipeline",
  "pack": {
    "steps": ["parse", "final"],
    "input_schema": { "...": "..." }
  }
}

7错误规范

MCP 公共契约将错误收敛到少量稳定代码，便于客户端直接处理。

8计费与限额

当前产品在 Hosted MCP 网关内分成两类能力：免费 helper 工具和托管模型能力。纯本地 Skills 不经过这些 API。

免费 Helper 工具

• get_workflow_pack：免费，用于本地工作流执行，不触发托管付费模型
• search_kb：免费，但属于 hosted knowledge search，并有 user 级日限额

托管模型能力

• 8 个 pipeline 工具通过托管模型运行，按量计费
• 余额接口和估价接口只用于托管模型模式

当前默认限额

9客户端接入

当前这里描述的是 Hosted MCP 网关接入。对外最值得强调的一点是：Zotero 已经可以直接连进来，文献收藏夹、最近文献和单条条目都能读。写作环境这边，再根据不同软件选择远程 Hosted MCP、本地 Skills 或本地 stdio 的方式。

哪些软件可以接，怎么接

Claude Desktop

编辑 claude_desktop_config.json（菜单 → Settings → Developer → Edit Config），加入以下配置：

{
  "mcpServers": {
    "miwrite": {
      "type": "url",
      "url": "https://miwrite.art/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_API_KEY"
      }
    }
  }
}

Cursor

在项目根目录创建 .cursor/mcp.json，或在全局 ~/.cursor/mcp.json 中加入以下配置：

{
  "mcpServers": {
    "miwrite": {
      "url": "https://miwrite.art/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_API_KEY"
      }
    }
  }
}

10Skill System

miwrite provides 9 local skills for Claude Code, Codex, Cursor, and similar local agents. These skills are separate from the hosted MCP service: they do not require login, do not require MIWRITE_API_KEY, and do not use the hosted knowledge base.

Install

curl -fsSL https://raw.githubusercontent.com/lcrxgzl-wq/miwrite.skill/main/install-claude.sh | bash

curl -fsSL https://raw.githubusercontent.com/lcrxgzl-wq/miwrite.skill/main/install-codex.sh | bash

claude mcp add-json miwrite '{"type":"url","url":"https://miwrite.art/mcp","headers":{"Authorization":"Bearer mcp_YOUR_API_KEY"}}'

Local Skill List

11更新日志

• 当前 Hosted MCP 公开 8 个 pipeline 工具。
• search_kb 已升级为正式可调用 free tool。
• get_workflow_pack 已升级为正式可调用 free tool，用于本地工作流执行。
• 公开文档新增知识库介绍，明确 bundle registry、search_kb 与 MCP resources 的统一边界。
• 本地 Skills 已与 Hosted MCP 解耦。
• expert_paid 已从公开 model profile 列表移除，但旧输入兼容保留。