AL

anton15k/llm_wiki_agent

Productivity workflow

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

34 stars 5 forks Качество 63 Тренд 12MIT

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.

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

Открыть полный README на GitHub

Установка

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-..." } } } }