AL

anton15k/llm_wiki_agent

Productivity workflow

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

34 stars 5 forks 품질 63 트렌드 12MIT

MCP 서버는 Claude Code와 Interlinked Obsidian wiki로 소스를 전환합니다.

개요

원시 소스를 전환하는 개인 지식 관리 시스템 - URL, PDF, 오디오, 비디오 - 인터링크드 위키에. Kotlin + Spring Boot에서 MCP 서버로 내장되어 Claude Code로 쌍합니다. 서버는 도구 키트이며, Claude는 두뇌입니다. LLM을 사용하여 Andrej Karpathy의 패턴에 영감을 받아 RAG 대신 개인 위키를 구축합니다. Claude Code는 URL, PDF 또는 오디오 파일을 제공합니다. 그것은 콘텐츠를 추출하기 위해 서버를 호출, 그 자체 지능을 사용 하 여 적절 한 구조와 위키 페이지에 그것을 증류, 크로스 링크 및 메타 데이터. wiki는 Obsidian-compatible vault입니다. - - Amazon Corretto 또는 JDK 21 + - - 설치 가이드 - (선택 사항) - 비디오 transcription (brew install ffmpeg)에만 필요한 - (선택 사항) - 오디오 / 비디오 transcription에만 필요한 build/libs/wiki-agent.jar (~70MB, Apache Tika 포함)를 생성합니다. Use -s 사용자는 모든 프로젝트에서 서버를 사용할 수 있습니다. 사용 - 현재 프로젝트의 프로젝트 만.

개요(AI 번역)

원시 소스를 전환하는 개인 지식 관리 시스템 - URL, PDF, 오디오, 비디오 - 인터링크드 위키에. Kotlin + Spring Boot에서 MCP 서버로 내장되어 Claude Code로 쌍합니다. 서버는 도구 키트이며, Claude는 두뇌입니다.

LLM을 사용하여 Andrej Karpathy의 패턴에 영감을 받아 RAG 대신 개인 위키를 구축합니다.

그것이 작동하는 방법

Claude Code는 URL, PDF 또는 오디오 파일을 제공합니다. 그것은 콘텐츠를 추출하기 위해 서버를 호출, 그 자체 지능을 사용 하 여 적절 한 구조와 위키 페이지에 그것을 증류, 크로스 링크 및 메타 데이터. wiki는 Obsidian-compatible vault입니다.

필수품

-Java 21+ — Amazon Corretto 또는 JDK 21+

  • Claude Code - 설치 가이드
  • ffmpeg (선택 사항) - 비디오 transcription에만 필요한 (brew install ffmpeg)
  • **OpenAI API 키 ** (옵션) - 오디오 / 비디오 트래픽에만 필요한

빠른 시작

1. 빌드

이 생성 build/libs/wiki-agent.jar (~70MB, Apache Tika 포함).

##2. Claude 코드 등록

-s user] 를 사용하여 모든 프로젝트에서 서버를 사용할 수 있습니다. -s project] 를 사용하여 현재 프로젝트에만 사용됩니다.

##3. 경로 구성 (추천)

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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

GitHub에서 전체 README 보기

설치

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