miwrite MCP 接入指南

1概述

公开目录记录了 8 个付费 pipeline 和 8 个免费 helper 的实现契约。远程开关启用后，客户端可先用 list_model_profiles 查看可用模型，再调用 pipeline；当前生产只能查看目录，不能远程调用。付费 pipeline 可传 module_ids；未传时服务端自动选择至多 6 个知识模块。

2远程接入参考

以下步骤说明远程能力启用后的接入契约。当前生产远程开关关闭，不能获取 API key 或调用这些端点。现在可使用 npm run mcp:dev 启动本地 stdio，查看公开目录，或安装下文的 Local Skills。

第一步：获取 API Key（当前不可用）

远程能力启用后，可在 MCP 控制台 登录并创建 key。默认 key 包含 catalog.read、tools.list、tools.call、pipelines、mcp.read、status.read。包括免费 helper 工具在内，所有 Hosted MCP 远程接口都需要 API key；纯本地 Skills 不需要登录。当前生产的 key 创建、列出和撤销路由均已关闭。

第二步：列出工具

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。发现、状态与目录 GET 接口公开可读；标为“生产关闭”的路径只表示代码契约存在，当前不会提供远程服务。

4工具参考

以下定义实时读取自公开的 /api/mcp/catalog，避免文档与实现漂移。目录可读不代表远程执行已开放；当前生产只能检查契约，不能调用 Pipeline 或 Hosted helper。

Pipeline 工具

Helper 工具

5知识库

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

当前包含什么

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

当前状态

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

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 工具

• list_model_profiles：免费返回当前模型档位、启用状态和服务端默认值
• get_workflow_pack：免费，返回本地执行所需的 prompt / steps / schema，不触发托管付费模型
• search_kb：免费 hosted 知识检索；默认 hybrid_chunk，可 mode=keyword；单独日限额
• search_kb 结果带回 chunk 元数据：chunk_id、source_path、heading、start_line、end_line
• get_template / get_term_map：免费取模板骨架与术语表
• verify_claims：免费本地主张 vs 原文审计（非开放网页查证）
• extract_citations / verify_citations：免费引用抽取与存在性核验

托管模型能力

• 8 个 pipeline 工具通过托管模型运行，按量计费
• 可选 module_ids 指定知识模块；未传时自动选择 ≤6 个 defaults
• 余额接口和估价接口只用于托管模型模式

模型选择

所有付费 pipeline 都接受可选 model_profile。省略时使用 list_model_profiles 返回的 default_model_profile；调用前应以该工具返回的 enabled 状态为准。

远程启用后的默认限额

9客户端接入

这里描述的是 Hosted MCP 已实现的客户端契约。代码层面，对外最值得强调的一点是：Zotero 已经可以直接连进来，文献收藏夹、最近文献和单条条目都能读；但当前生产远程开关关闭，外部客户端暂时不能连接。现在请使用本地 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更新日志

完整条目见仓库 CHANGELOG.md。以下记录代码契约的演进，不代表当前生产已启用远程服务；部署可用性以页首状态为准。

2026-08-04

• 新增免费 list_model_profiles，Hosted MCP 客户端可在付费调用前发现默认模型与当前启用状态。
• 8 个 pipeline 的 model_profile 在 tools/list 中提供明确枚举。
• 产品品牌统一为 miwrite，定位扩展为通用文档与知识工作台；学术能力保留为专业 Skills 和模块。

2026-07-12

• Hosted MCP 正式可调用免费 helper：从 2 个扩到 7 个（含 get_template、get_term_map、verify_claims、extract_citations、verify_citations）。
• search_kb 默认 hybrid（关键词 + 本地 TF-IDF）；chunk 元数据保持返回。
• 付费 pipeline 支持可选 module_ids；未传时自动选择 ≤6 个知识模块。
• verify_claims 仅做本地主张 vs 原文审计，不承诺开放网页事实核查。
• 限额：仅 search_kb 使用独立日限额；其余免费 helper 与托管 tools/call 共用日限额桶。
• 本地 Skills 补充 Minimum inputs / Output skeleton，并与 Hosted MCP 继续解耦。

更早

• Hosted MCP 公开 8 个 pipeline 工具。
• search_kb / get_workflow_pack 升级为正式可调用 free tool。
• 公开文档明确 bundle registry、search_kb 与 MCP resources 的统一边界。
• expert_paid 已从公开 model profile 列表移除，但旧输入兼容保留。