Dewey

@meetdewey/mcp

适用于 Dewey 的 MCP 服务——可通过 Claude、Cursor 和任何兼容 MCP 的 Agent 搜索和研究文档集合。详情请参阅完整 API 参考。

安装

将以下内容添加到 claude_desktop_config.json（或同等的 MCP 客户端配置）中：

{
  "mcpServers": {
    "dewey": {
      "command": "/bin/sh",
      "args": ["-lc", "npx -y @meetdewey/mcp"],
      "env": {
        "DEWEY_API_KEY": "dwy_live_...",
        "DEWEY_COLLECTION_ID": "..."
      }
    }
  }
}

**Windows 用户须知：**将 "command": "/bin/sh" 和 "args": ["-lc", "npx -y @meetdewey/mcp"] 替换为 "command": "npx" 和 "args": ["-y", "@meetdewey/mcp"]——登录 shell 包装器仅在 macOS/Linux 上需要，用于加载 Claude Desktop 不会继承的 Homebrew 和 nvm PATH 条目。

环境变量

变量	必填	说明
DEWEY_API_KEY	是	您的 Dewey 项目 API 密钥
DEWEY_COLLECTION_ID	否	默认集合 ID。设置后，接受 collection_id 的工具会在未提供该值时使用此默认值。
DEWEY_API_URL	否	覆盖 API 基础 URL（默认值：https://api.meetdewey.com/v1）

可用工具

搜索与研究

工具	说明
dewey_list_collections	列出项目中的所有集合，包括已设置的描述和研究说明
dewey_search	对分块内容进行语义与关键词混合搜索
dewey_scan_sections	对章节标题和摘要进行轻量级搜索
dewey_research	可配置研究深度的 Agent 式研究查询——返回有依据且附带引用的答案
dewey_get_section	根据 ID 获取章节的完整 Markdown 内容

文档管理

工具	说明
dewey_list_documents	列出集合中的文档及其处理状态
dewey_get_document_sections	列出文档中的所有章节（含标题层级和 ID 的目录）
dewey_get_document_markdown	获取文档转换后的完整 Markdown 内容
dewey_retry_document	重试处理失败的文档——清除错误状态并重新加入处理队列
dewey_delete_document	永久删除文档及其所有衍生数据

声明与矛盾

工具	说明
dewey_list_claims	列出从集合或指定文档中提取的事实声明，可按重要性（1–5）筛选
dewey_list_contradictions	列出检测到的矛盾——包含相互冲突的声明簇、说明和建议的解决方案
dewey_detect_contradictions	在集合的所有声明中启动异步矛盾检测
dewey_get_contradiction_run	获取最新矛盾检测任务的状态和统计信息（在 dewey_detect_contradictions 后用于轮询）
dewey_resolve_contradiction	对矛盾应用解决指令，或将其驳回

去重

工具	说明
dewey_detect_duplicates	启动异步去重任务——通过衡量各分块之间的共享内容识别近重复文档，并将每组中的一个文档标记为规范文档
dewey_get_duplicate_run	获取最新去重任务的状态和统计信息（在 dewey_detect_duplicates 后用于轮询）
dewey_list_duplicate_groups	列出近重复文档组，包括规范文档、组内成员和覆盖率百分比
dewey_promote_duplicate_canonical	将另一成员提升为规范文档；原规范文档将变为近重复文档
dewey_disband_duplicate_group	解散一个文档组；原成员将作为独立文档重新参与检索

非规范文档不会参与检索和矛盾检测。需要在集合中启用 enableDeduplication: true（通过 dewey_update_collection 或 Dewey 控制台进行设置）。

集合设置

工具	描述
dewey_get_collection_stats	获取文档数量、存储空间、章节／分块／主张数量，以及处理状态分布
dewey_update_collection	更新集合名称、描述、研究说明、可见性和功能标志
dewey_recompute_summaries	对所有文档重新运行 AI 章节摘要生成（例如，更改 LLM 模型后）
dewey_recompute_captions	对所有文档中的图片和表格重新运行 AI 说明生成
dewey_delete_collection	永久删除集合及其所有数据

研究说明

集合可以设置自然语言说明，这些说明会自动注入研究系统提示词中，例如注明单位、偏好的来源，或如何处理缺失信息。可以在 Dewey 控制面板中、通过 API 或直接使用 dewey_update_collection 设置这些说明。使用 dewey_resolve_contradiction 应用解决方案时，建议的说明也会自动追加到此处。

工具使用模式

典型的只读研究工作流：

1. dewey_list_collections — 发现可用集合并了解其用途
2. dewey_scan_sections — 快速浏览文档结构，找出相关章节
3. dewey_get_section — 加载特定章节的完整内容
4. dewey_search — 为具体问题检索最相关的分块
5. dewey_research — 针对需要多步推理的问题运行完整的 Agentic 研究查询

用于深入分析和整理：

1. dewey_get_collection_stats — 评估已处理的内容量
2. dewey_list_claims — 汇总文档中最重要的事实
3. dewey_list_contradictions — 找出文档之间的矛盾之处
4. dewey_resolve_contradiction — 应用或驳回每项矛盾，并自动更新集合说明

许可证

MIT