llmwiki MCP Server

社区

将原始资料编译为可追溯的互联知识库。

分类: 开发工具第 158 / 438
Stars: ★ 2.2k 非常热门
运行环境: Node.js 24+
凭据: 可选 API Key
许可证: MIT
最近提交: 7 天前
工具数: 2

57FMRS · C

来源表明该项目提供 MCP 服务和两个明确命名的 MCP 工具 get_context_pack、run_eval，但未说明具体传输协议、客户端兼容性或客户端安装配置。项目为 MIT 许可，服务器路径为仓库根目录；其主要价值是将资料编译成可审阅、可引用和可检索的知识库。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

12/20

文档质量

15/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: README 描述了 MCP 服务、工具范围、提供商和失败关闭机制，但服务器清单未缓存，且未提供实际 MCP 初始化/工具列表响应、源码或已提交的服务器测试证据。CI 和测试命令仅由 README 声称，静态审查无法验证关键路径、错误处理或依赖可控性，因此仅给出合理但未证实的可行性分数。
安全与权限 12/20: README 声称具备项目路径限制、凭据按调用校验、外部导入默认进入审核队列、工件哈希校验、大小限制和只读查看器，这些显示出较明确的安全设计。扣分原因是没有可审查的实现、工具级权限矩阵、MCP 客户端授权配置、网络访问细节或危险写操作的逐次确认证据；因此不能按最优情况推断。未发现提示材料中的明确红线风险。
维护活跃度 12/20: 仓库标注 MIT、未归档，README 声称已发布 1.1.0/1.0.0，并提到 CI、贡献指南和 15 个开放 issue，说明项目存在维护活动。扣分原因是仅有 README 级证据，缺少可核验的提交历史、发布频率、依赖更新、漏洞响应渠道和 issue 响应质量；Stars 不计分。
文档质量 15/20: README 覆盖功能边界、命令、MCP 启动方式、SDK、Node.js 版本、多个提供商、环境变量、导入导出、质量模型、限制和文档入口，并给出可执行的示例。扣分原因是没有具体 MCP 工具参数/返回值、主流客户端连接配置、成本与速率限制、故障排查证据，且文档内容未由清单或源码交叉验证。
安装易用性 10/20: README 给出了 Node.js 24、npm 全局安装、环境变量、项目初始化和 `llmwiki serve --root` 的基本路径，也列出了无需凭据的部分能力。扣分原因是没有主流 MCP 客户端配置示例，Node.js 24 要求偏高，提供商和凭据选择增加配置复杂度，且缺少实际握手或跨平台验证证据。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

需要审阅、引用追踪和持续复用的研究资料
代码库文档、团队手册、标准、设计笔记和决策记录
希望在查询前预编译知识结构的代理工作流

不适合谁

高频变化且原始搜索已足够的日志流
通用静态网站生成
重型本体数据库

所需权限

需要访问指定知识库项目根目录及其 sources、wiki 和 .llmwiki 数据
摄取网页或外部连接器数据时需要相应的网络访问能力；README 未说明具体连接器权限
LLM 支持的操作在调用时需要配置相应提供商凭据

风险与副作用

编译内容由 LLM 生成，可能出现置信度、矛盾、来源或陈旧性问题
外部 OKF 导入默认进入审阅队列，但显式信任的导入会写入活动知识库
写入、连接器和导入操作可能改变知识库内容，应使用审阅、lint 和 eval 检查
README 未提供具体 MCP 客户端配置或传输方式，不能据此假定客户端兼容性

安装接入

准备工作

运行环境：Node.js 24+

ANTHROPIC_API_KEY 可选密钥 Anthropic API 密钥，默认 LLM 提供商凭据，用于 LLM 相关工具；从 Anthropic 控制台获取。

ANTHROPIC_AUTH_TOKEN 可选密钥 Anthropic 认证令牌，ANTHROPIC_API_KEY 的替代凭据。

OPENAI_API_KEY 可选密钥 OpenAI 兼容提供商的 API 密钥，当 LLMWIKI_PROVIDER=openai 时需要。

GITHUB_TOKEN 可选密钥 GitHub Copilot 提供商的令牌，通常设为 $(gh auth token)。

其他可选配置项（4 个）

LLMWIKI_PROVIDER 可选选择 LLM 提供商，可选值包括 openai、ollama、copilot、claude-agent；不设则默认 anthropic。

OPENAI_BASE_URL 可选可选，指定 OpenAI 兼容服务的基础 URL。

OLLAMA_HOST 可选 Ollama 服务的主机地址，当 LLMWIKI_PROVIDER=ollama 时使用。

LLMWIKI_COMPILE_CONCURRENCY 可选可选，配置编译时的并发上限。

需要 Node.js 24 或更高版本。运行 npm install -g llm-wiki-compiler 安装，然后在知识库项目中运行 llmwiki serve --root <项目目录>。

验证是否装好

运行 `llmwiki serve --root /path/to/wiki-project` 后，在 MCP 客户端工具列表中确认出现 get_context_pack 和 run_eval；调用 run_eval（fast 套件无需任何 API key）并返回健康得分即证明连接成功。

常见排障

确认 Node.js 版本至少为 24
确认 --root 指向包含知识库项目的目录
运行 llmwiki status、llmwiki lint 和 llmwiki eval 检查状态与质量
LLM 支持的操作失败时，检查所选提供商及其凭据配置
若页面陈旧，先运行 llmwiki refresh --stale --dry-run 再决定是否修复

试试这样问

连接成功后，可以直接对 AI 助手这样说：

为任务"总结本项目的核心概念"构建一个上下文包
运行快速评估套件，告诉我当前 wiki 的健康得分
为我的研究 wiki 运行完整评估，检查引用覆盖率
获取一个包含引用的上下文包，供另一个 agent 使用

工具能力 2

get_context_pack 只读

为代理生成带引用的证据上下文包。

run_eval 写入

运行知识库质量评估；快速套件无需提供商，完整套件的引用支持评判需要提供商。

使用场景

把原始资料编译成持久化的互联 Markdown 知识库

为代理生成带引用的证据上下文包

检查引用、链接、陈旧页面和知识库质量

通过 MCP 查询、读取和交换已编译知识

详细介绍

llmwiki 是一个知识编译器，可将论文、笔记、README、转录稿、PDF、图片或网页编译成带引用、元数据、审阅状态和互联关系的 Markdown wiki。其 MCP 服务可供兼容 MCP 的代理执行资料摄取、编译、查询、页面读取、质量检查、评估、状态查看、上下文包生成及 Open Knowledge Format 交换。服务器路径为项目根目录。