
anton15k/llm_wiki_agent
Productivity workflowЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP-сервер, который превращает необработанные источники во взаимосвязанную обсидиановую вики с кодом Клода.
Обзор
Система управления личными знаниями, которая превращает необработанные источники — URL, PDF, аудио, видео — в взаимосвязанную вики. Построенный как MCP-сервер в Kotlin + Spring Boot, он сочетается с кодом Клода: сервер — это инструментарий, Клод — это мозг. Вдохновленная моделью Андрея Карпати с использованием LLM для постепенного создания личной вики вместо RAG. Вы предоставляете Claude Code URL, PDF или аудиофайл. Он вызывает сервер для извлечения контента, а затем использует свой собственный интеллект для перегонки его на вики-страницы с правильной структурой, перекрестными ссылками и метаданными. Вики - это хранилище, совместимое с Obsidian, которое вы можете просматривать и искать. Amazon Corretto или любой JDK 21+ - - Руководство по установке - (необязательно) - требуется только для видеотранскрипции (пивоустановка ffmpeg) - (необязательно) - требуется только для аудио / видео транскрипции Производится сборка/libs/wiki-agent.jar (~70 МБ, включая Apache Tika). Используйте его, чтобы сделать сервер доступным во всех проектах. Используйте -s проект только для текущего проекта.
Обзор (машинный перевод)
Система управления личными знаниями, которая превращает необработанные источники — URL, PDF, аудио, видео — в взаимосвязанную вики. Построенный как MCP-сервер в Kotlin + Spring Boot, он сочетается с кодом Клода: сервер — это инструментарий, Клод — это мозг.
Вдохновленная моделью Андрея Карпати с использованием LLM для постепенного создания личной вики вместо RAG.
Как это работает
Вы предоставляете Claude Code URL, PDF или аудиофайл. Он вызывает сервер для извлечения контента, а затем использует свой собственный интеллект для перегонки его на вики-страницы с правильной структурой, перекрестными ссылками и метаданными. Вики - это хранилище, совместимое с Obsidian, которое вы можете просматривать и искать.
Предпосылки
Java 21+ — Amazon Corretto или JDK 21+ Claude Code - Руководство по установке ffmpeg (необязательно) — требуется только для видеотранскрипции ([T0]) ** API-ключ OpenAI** (необязательно) — требуется только для аудио/видео транскрипции
Быстрый старт
###1 Построить
Это производит build/libs/wiki-agent.jar (~70 МБ, включая Apache Tika).
###2 Зарегистрируйтесь с кодом Клода
Используйте -s user, чтобы сделать сервер доступным во всех проектах. Используйте [[Т3]] только для текущего проекта.
###3. Настройка путей (рекомендуется)
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
LLM Wiki Agent
A personal knowledge management system that turns raw sources — URLs, PDFs, audio, video — into an interlinked wiki. Built as an MCP server in Kotlin + Spring Boot, it pairs with Claude Code: the server is the toolkit, Claude is the brain.
Inspired by Andrej Karpathy’s pattern of using LLMs to incrementally build a personal wiki instead of RAG.
How It Works
Claude Code (LLM — all intelligence)
│ MCP protocol (STDIO)
▼
Wiki Agent Server (toolkit — zero LLM calls)
├── Content extraction (URL, PDF, text, audio, video)
├── Wiki management (CRUD, search, index, log)
│
▼ filesystem
wiki/ (Obsidian vault) raw/ (immutable sources)
You give Claude Code a URL, PDF, or audio file. It calls the server to extract content, then uses its own intelligence to distill it into wiki pages with proper structure, cross-links, and metadata. The wiki is an Obsidian-compatible vault you can browse and search.
Prerequisites
- Java 21+ — Amazon Corretto or any JDK 21+
- Claude Code — Installation guide
- ffmpeg (optional) — required only for video transcription (
brew install ffmpeg) - OpenAI API key (optional) — required only for audio/video transcription
Quick Start
1. Build
git clone && cd llm_wiki_agent
./gradlew bootJar
This produces build/libs/wiki-agent.jar (~70MB, includes Apache Tika).
2. Register with Claude Code
claude mcp add -s user wiki-agent \
-- java -jar /absolute/path/to/llm_wiki_agent/build/libs/wiki-agent.jar
Use -s user to make the server available in all projects. Use -s project for the current project only.
3. Configure paths (recommended)
By default, the wiki and raw directories are created relative to the working directory. For a persistent setup, set absolute paths in ~/.claude.json under the mcpServers entry:
{
"mcpServers": {
"wiki-agent": {
"type": "stdio",
"command": "java",
"args": ["-jar", "/absolute/path/to/wiki-agent.jar"],
"env": {
"WIKI_PATH": "/absolute/path/to/wiki",
"RAW_PATH": "/absolute/path/to/raw",
"OPENAI_API_KEY": "sk-..."
}
}
}
}
4. Verify
claude mcp list
# wiki-agent: java -jar ... - ✓ Connected
5. Open in Obsidian (optional)
Open your wiki/ directory as an Obsidian vault to get a graph view of all your pages and their [[wikilinks]].
MCP Tools
Content Extraction
| Tool | Description |
|---|---|
wiki_extract |
Extract content from a URL, PDF, or text file. Auto-detects source type. Saves raw extraction to raw/. |
wiki_transcribe |
Transcribe audio/video via OpenAI Whisper. For video, extracts audio with ffmpeg first. Requires OPENAI_API_KEY. |
Wiki Management
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"wiki-agent": {
"type": "stdio",
"command": "java",
"args": ["-jar", "/absolute/path/to/wiki-agent.jar"],
"env": {
"WIKI_PATH": "/absolute/path/to/wiki",
"RAW_PATH": "/absolute/path/to/raw",
"OPENAI_API_KEY": "sk-..."
}
}
}
}