URL、PDF、音声、ビデオなどのソースをインターリンクしたwikiに変える個人ナレッジ管理システム。 Kotlin + Spring Boot の MCP サーバーとして構築され、Claude Code と組み合わせます。サーバーはツールキットで、Claude は脳です。

LLM を使用して Andrej Karpathy のパターンをインスパイアし、RAG の代わりに個人的な wiki を構築します。

使い方

ClaudeコードをURL、PDF、またはオーディオファイルにします。 コンテンツを抽出するためにサーバーを呼び出し、独自のインテリジェンスを使用して、適切な構造、クロスリンク、メタデータをwikiページに蒸留します。 wiki は、閲覧と検索が可能な Obsidian 互換の vault です。

前提条件

• Java 21+ — Amazon Corretto または JDK 21+
• ロードコード — インストールガイド -ffmpeg(オプション) — ビデオトランスクリプション([brew install ffmpeg)のみに必要 -OpenAI APIキー(オプション) — 音声/ビデオのトランスクリプションのみ

クイックスタート

##1. ビルド

build/libs/wiki-agent.jar (~70MB、Apache Tikaを含む) を生成します。

##2. クラウデコードに登録する

-s user を使用して、すべてのプロジェクトでサーバーを利用できるようにします。 現在のプロジェクトのみに-s projectを使用します。

##3. パスの設定(推奨)

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

Wiki Management