Skip to content

LLM Wiki is a cross-platform desktop application that turns your documents into an organized, interlinked knowledge base — automatically. Instead of traditional RAG (retrieve-and-answer from scratch every time), the LLM incrementally builds and maintains a persistent wiki from your sources。

TypeScript

docs: document api and mcp support

nash_su2f83c04143f9
diff --git a/README.md b/README.md
index 2a9e8892..a3f9f1f8 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,7 @@
- **Deep Research** — LLM-optimized search topics, multi-query web search via Tavily, SerpApi, or SearXNG, auto-ingest results into wiki
- **Async Review System** — LLM flags items for human judgment, predefined actions, pre-generated search queries
- **Chrome Web Clipper** — one-click web page capture with auto-ingest into knowledge base
-- **Local HTTP API + AI Agent Skill** — built-in `127.0.0.1:19828` JSON API (token-protected) for hybrid search, file read, graph traversal, and source rescan; ready-made [agent skill](https://github.com/nashsu/llm_wiki_skill) installs into Claude Code / Codex with one command (`npx skills add …`)
+- **Local HTTP API + MCP Server + AI Agent Skill** — built-in `127.0.0.1:19828` JSON API and bundled MCP server for hybrid search, file read, graph traversal, and source rescan; ready-made [agent skill](https://github.com/nashsu/llm_wiki_skill) installs into Claude Code / Codex with one command (`npx skills add …`)
## What is this?
@@ -407,7 +407,7 @@ npm run tauri build # Production build
8. Check **Review** for items needing your attention
9. Run **Lint** periodically to maintain wiki health
-## Local HTTP API + AI Agent Skill
+## Local HTTP API + MCP Server + AI Agent Skill
LLM Wiki ships a built-in local HTTP API at `http://127.0.0.1:19828` (token-protected, `127.0.0.1`-only) so external tools — including AI agents like **Claude Code**, **Codex**, or any HTTP-capable script — can query your wiki:
@@ -418,7 +418,9 @@ LLM Wiki ships a built-in local HTTP API at `http://127.0.0.1:19828` (token-prot
- `GET /api/v1/projects/{id}/graph` — wikilinks graph
- `POST /api/v1/projects/{id}/sources/rescan` — trigger a backend rescan
-Enable + generate a token in **Settings → API Server**.
+Enable the API, generate a token, and choose whether local unauthenticated access is allowed in **Settings → API + MCP**.
+
+For MCP-compatible clients, LLM Wiki also includes a local MCP server in `mcp-server/`. After building it with `npm run mcp:build`, **Settings → API + MCP** shows a copyable MCP client configuration with the correct local path for your machine. The MCP tools call the same API surface, so agent clients can list projects, read files, run hybrid search, inspect the graph, and trigger source rescans without custom HTTP glue code.
### Plug your AI agent in with one command
diff --git a/README_CN.md b/README_CN.md
index 7da896b4..21cc24d3 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -42,7 +42,7 @@
- **深度研究** — LLM 智能生成搜索主题,通过 Tavily、SerpApi 或 SearXNG 进行多查询网络搜索,研究结果自动摄入 Wiki
- **异步审核系统** — LLM 在摄入时标记需人工判断的项,预定义操作,预生成搜索查询
- **Chrome 网页剪藏** — 一键捕获网页内容,自动摄入知识库
-- **本地 HTTP API + AI Agent Skill** — 内置 `127.0.0.1:19828` JSON API(Token 鉴权),支持 Hybrid 检索、文件读取、知识图谱遍历、源资料重新扫描;配套 [agent skill](https://github.com/nashsu/llm_wiki_skill) 一行命令接入 Claude Code / Codex(`npx skills add …`)
+- **本地 HTTP API + MCP Server + AI Agent Skill** — 内置 `127.0.0.1:19828` JSON API 和随包提供的 MCP Server,支持 Hybrid 检索、文件读取、知识图谱遍历、源资料重新扫描;配套 [agent skill](https://github.com/nashsu/llm_wiki_skill) 一行命令接入 Claude Code / Codex(`npx skills add …`)
## 这是什么?
@@ -407,7 +407,7 @@ npm run tauri build # 生产构建
8. 查看 **审核** 处理需要你关注的项目
9. 定期运行 **Lint** 维护 Wiki 健康度
-## 本地 HTTP API + AI Agent Skill
+## 本地 HTTP API + MCP Server + AI Agent Skill
LLM Wiki 内置一个本地 HTTP API(监听 `http://127.0.0.1:19828`,Token 鉴权,仅本机可达),任何外部工具——包括 **Claude Code**、**Codex** 这类 AI Agent,或者任意能发 HTTP 请求的脚本——都可以直接查询你的知识库:
@@ -418,7 +418,9 @@ LLM Wiki 内置一个本地 HTTP API(监听 `http://127.0.0.1:19828`,Token
- `GET /api/v1/projects/{id}/graph` —— Wikilinks 知识图谱
- `POST /api/v1/projects/{id}/sources/rescan` —— 触发后端重新扫描
-在 **设置 → API 服务** 中开启 API 并生成 Token。
+在 **设置 → API + MCP** 中开启 API、生成 Token,并按需选择是否允许本机无鉴权访问。
+
+对于兼容 MCP 的客户端,LLM Wiki 还内置了 `mcp-server/`。执行 `npm run mcp:build` 构建后,**设置 → API + MCP** 会展示一份可复制的 MCP 客户端配置,并自动填入当前机器上的真实入口路径。MCP 工具复用同一套 API 能力,因此 Agent 可以直接列出项目、读取文件、执行 Hybrid 检索、查看图谱和触发资料源重新扫描,不需要再手写 HTTP 调用。
### 一条命令把 AI Agent 接进你的知识库
diff --git a/README_JA.md b/README_JA.md
index dac8c0ae..c25f3f10 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -42,7 +42,7 @@
- **Deep Research** — LLM が検索トピックを最適化生成し、Tavily / SerpApi / SearXNG によるマルチクエリ Web 検索結果を自動で Wiki 化
- **非同期レビューシステム** — LLM が人間の判断を要する項目を作成し、定義済みアクションと事前生成された検索クエリを付与
- **Chrome Web Clipper** — Web ページをワンクリックで取り込み、知識ベースへ自動インジェスト
-- **ローカル HTTP API + AI Agent Skill** — `127.0.0.1:19828` の JSON API(Token 認証)でハイブリッド検索、ファイル読み取り、グラフ探索、ソース再スキャンを提供。専用の [agent skill](https://github.com/nashsu/llm_wiki_skill) はワンコマンドで Claude Code / Codex に追加可能(`npx skills add …`)
+- **ローカル HTTP API + MCP Server + AI Agent Skill** — `127.0.0.1:19828` の JSON API と同梱 MCP Server でハイブリッド検索、ファイル読み取り、グラフ探索、ソース再スキャンを提供。専用の [agent skill](https://github.com/nashsu/llm_wiki_skill) はワンコマンドで Claude Code / Codex に追加可能(`npx skills add …`)
## これは何ですか?
@@ -416,7 +416,7 @@ npm run tauri build # 本番ビルド
8. **レビュー** で対応が必要な項目を確認
9. **Lint** を定期的に実行し、Wiki の健全性を維持
-## ローカル HTTP API + AI Agent Skill
+## ローカル HTTP API + MCP Server + AI Agent Skill
LLM Wiki は組み込みのローカル HTTP API(`http://127.0.0.1:19828` でリッスン、Token 認証、ローカルホストのみ)を提供します。**Claude Code** や **Codex** などの AI エージェント、または HTTP リクエストを発行できる任意のスクリプトから、直接知識ベースを問い合わせることができます。
@@ -427,7 +427,9 @@ LLM Wiki は組み込みのローカル HTTP API(`http://127.0.0.1:19828` で
- `GET /api/v1/projects/{id}/graph` — wikilinks の知識グラフ
- `POST /api/v1/projects/{id}/sources/rescan` — バックエンドの再スキャンをトリガー
-**設定 → API サーバー** から API を有効化し、Token を発行してください。
+**設定 → API + MCP** から API を有効化し、Token を発行できます。必要に応じて、ローカルからの認証なしアクセスも切り替えられます。
+
+MCP 互換クライアント向けに、LLM Wiki には `mcp-server/` も同梱されています。`npm run mcp:build` でビルドしたあと、**設定 → API + MCP** に現在のマシンに合ったパス入りの MCP クライアント設定が表示され、そのままコピーできます。MCP ツールは同じ API を利用するため、エージェントはプロジェクト一覧、ファイル読み取り、ハイブリッド検索、グラフ参照、ソース再スキャンをカスタム HTTP 実装なしで実行できます。
### ワンコマンドで AI エージェントを接続
diff --git a/README_KO.md b/README_KO.md
index 817307d4..03e33581 100644
--- a/README_KO.md
+++ b/README_KO.md
@@ -42,7 +42,7 @@
- **Deep Research** — LLM에 최적화된 검색 주제와 Tavily, SerpApi, SearXNG 기반 다중 쿼리 웹 검색을 사용하고, 결과를 자동으로 Wiki에 인제스트합니다
- **비동기 리뷰 시스템** — LLM이 사람의 판단이 필요한 항목을 표시하고, 사전 정의된 작업과 미리 생성된 검색 쿼리를 제공합니다
- **Chrome Web Clipper** — 웹 페이지를 한 번의 클릭으로 캡처하고 지식 베이스에 자동 인제스트합니다
-- **로컬 HTTP API + AI Agent Skill** — 내장 `127.0.0.1:19828` JSON API(Token 보호)를 통해 하이브리드 검색, 파일 읽기, 그래프 탐색, 소스 재스캔을 지원합니다. 바로 사용할 수 있는 [agent skill](https://github.com/nashsu/llm_wiki_skill)은 한 줄 명령(`npx skills add ...`)으로 Claude Code / Codex에 설치할 수 있습니다
+- **로컬 HTTP API + MCP Server + AI Agent Skill** — 내장 `127.0.0.1:19828` JSON API와 번들 MCP Server를 통해 하이브리드 검색, 파일 읽기, 그래프 탐색, 소스 재스캔을 지원합니다. 바로 사용할 수 있는 [agent skill](https://github.com/nashsu/llm_wiki_skill)은 한 줄 명령(`npx skills add ...`)으로 Claude Code / Codex에 설치할 수 있습니다
## 이게 무엇인가요?
@@ -416,7 +416,7 @@ npm run tauri build # Production build
8. **Review**에서 주의가 필요한 항목을 확인합니다
9. **Lint**를 주기적으로 실행해 Wiki 상태를 유지합니다
-## 로컬 HTTP API + AI Agent Skill
+## 로컬 HTTP API + MCP Server + AI Agent Skill
LLM Wiki에는 `http://127.0.0.1:19828`의 내장 로컬 HTTP API가 포함되어 있습니다(Token 보호, `127.0.0.1` 전용). 이를 통해 **Claude Code**, **Codex** 또는 HTTP를 사용할 수 있는 스크립트 같은 외부 도구가 Wiki에 쿼리할 수 있습니다.
@@ -427,7 +427,9 @@ LLM Wiki에는 `http://127.0.0.1:19828`의 내장 로컬 HTTP API가 포함되
- `GET /api/v1/projects/{id}/graph` — wikilinks graph
- `POST /api/v1/projects/{id}/sources/rescan` — backend rescan trigger
-**Settings → API Server**에서 활성화하고 token을 생성하세요.
+**Settings → API + MCP**에서 API를 활성화하고 token을 생성할 수 있습니다. 필요하면 로컬 unauthenticated access도 켜거나 끌 수 있습니다.
+
+MCP 호환 클라이언트를 위해 LLM Wiki는 `mcp-server/`도 함께 제공합니다. `npm run mcp:build`로 빌드한 뒤 **Settings → API + MCP**에서 현재 머신의 실제 경로가 들어간 MCP client configuration을 복사할 수 있습니다. MCP tools는 같은 API surface를 사용하므로 에이전트는 별도 HTTP glue code 없이 project list, file read, hybrid search, graph inspect, source rescan을 실행할 수 있습니다.
### 한 줄 명령으로 AI 에이전트 연결하기