XKnow Knowledge Base

本地服务

xknow.org记忆与知识01 天前更新

代码仓库访问官网

关于 XKnow Knowledge Base

XKnow Knowledge Base 是一款本地 MCP 服务，用于搜索和探索精选的 SEO、SaaS 与 LLM-wiki 笔记。它支持来源引用和基于链接图谱的探索，可使用内置公开数据快照或本地 Markdown 知识库。

主要功能

01按相关度搜索并返回来源链接
02读取笔记全文
03探索关联概念与反向链接
04按主题分区列出笔记
05检查 SEO 与 SaaS 内容规则

适用场景

01查找并引用 SEO 指引
02探索知识主题的关联链接
03查看 SaaS 定价模式
04依据 XKnow 规则检查内容

MCP 相关

该服务通过本地 stdio 向 MCP 客户端提供 XKnow 笔记和内容检查工具。内置快照在查询时无需联网；完整知识库模式读取本地文件夹中的 Markdown 文件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "techreone-xknow": {
      "command": "npx",
      "args": [
        "-y",
        "xknow-mcp"
      ]
    }
  }
}

启动命令npx -y xknow-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmxknow-mcp1.0.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	integer	否	最大结果数（默认值为 8）
query	string	是	自然语言查询，例如“keyword difficulty”或“saas pricing models”
section	enum	否	限制在一个章节内seo \| saas \| blog

详细介绍

xknow-mcp

XKnow · MCP 服务页面 · 源代码 · npm · MCP Registry

面向 XKnow 知识库 的 MCP 服务——这是一个精心整理、相互链接的 SEO、SaaS 和 LLM wiki 知识库。让任何支持 MCP 的 Agent（Claude、Cursor、Cline、opencode 等）都能搜索并引用其中的内容。

本地且私密。 通过 stdio 在你的机器上运行。无需服务器、账号或 API 密钥。
静态数据。 免费层是公开 XKnow 指南的快照，随软件包一同提供。查询时不会获取任何内容。
支持知识图谱。 除了关键词搜索，explore_concept 还会遍历笔记之间的交叉链接，让 Agent 能够顺着主题探索，而不是只得到一份平面列表。

快速开始

将其添加到你的 MCP 客户端。

Claude Desktop（claude_desktop_config.json）、Cursor、Cline 和大多数客户端：

{
  "mcpServers": {
    "xknow": {
      "command": "npx",
      "args": ["-y", "xknow-mcp"]
    }
  }
}

Claude Code

claude mcp add xknow -- npx -y xknow-mcp

opencode（opencode.json）

{
  "mcp": {
    "xknow": { "type": "local", "command": ["npx", "-y", "xknow-mcp"], "enabled": true }
  }
}

然后可以向 Agent 提出类似这样的问题：

“使用 xknow 工具解释关键词难度，并引用来源。” “在 XKnow 中搜索 SaaS 定价模式，并总结其中的利弊。”

工具

工具	功能
`search_knowledge`	对知识库进行排序搜索。返回标题、摘要和 URL。
`get_page`	按标题或 slug 获取一篇笔记的全文（保留 `[[wikilinks]]`）。
`explore_concept`	返回一篇笔记及其出链和反向链接——遍历知识图谱。
`list_topics`	按分区（`seo`、`saas`、`blog`）列出所有笔记。
`lint_rules`	XKnow SEO/SaaS 内容自检规则——每条规则包含优先级（P0–P3）、原因、修复建议，以及为其提供依据的知识库笔记。
`cite`	返回笔记的规范引用信息（标题、描述、URL）。

两个知识层级

层级	内容	方式
免费（默认）	57 篇公开的 XKnow 指南和博客文章	随附快照——只需运行 `npx -y xknow-mcp`
完整知识库	你购买的 XKnow 知识库（500+ 篇相互链接的笔记）	`npx -y xknow-mcp --vault /path/to/SEO-SaaS-Vault`

完整知识库模式会读取本地文件夹中的 Markdown 笔记，因此你购买的副本不会离开你的机器。如果你更喜欢通过环境变量设置一次，可使用 XKNOW_VAULT：

export XKNOW_VAULT="/path/to/SEO-SaaS-Vault"
npx -y xknow-mcp

工作原理

xknow-mcp 是一个 Node.js stdio 服务。免费层是从公开网站生成并随软件包一同提供的静态 JSON 快照（data/knowledge.json）；搜索会对随附笔记进行轻量级排序，不依赖任何外部依赖。知识库模式会即时解析本地文件夹中的 Markdown 笔记。无需网络调用、向量数据库或遥测。

开发

npm install
npm run build:data   # refresh data/knowledge.json from https://xknow.org/mcp/knowledge.json
npm run build        # tsc
npm run smoke        # exercise every tool over a real stdio connection

# also test against a local vault
SMOKE_VAULT=/path/to/SEO-SaaS-Vault npm run smoke