literateMCP

by YUZongmin
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports source identification and management using arXiv identifiers for academic papers

  • Supports source identification and management using DOI identifiers for academic publications

  • Supports source identification and management using Semantic Scholar identifiers for academic papers

유니버설 소스 관리 시스템

다양한 유형의 소스(논문, 서적, 웹페이지 등)를 관리하고 이를 지식 그래프와 통합하기 위한 유연한 시스템입니다.

특징

핵심 기능

  • 내부 UUID 시스템을 통한 범용 소스 식별
  • 다양한 소스 유형(논문, 웹 페이지, 책, 비디오, 블로그) 지원
  • 소스당 여러 식별자 지원(arxiv, DOI, semantic scholar, ISBN, URL)
  • 제목과 내용이 포함된 체계적인 노트 작성
  • 상태 추적(읽지 않음, 읽는 중, 완료, 보관됨)

엔티티 통합

  • 지식 그래프 엔터티에 소스 연결
  • 소스와 엔터티 간의 관계 추적
  • 유연한 관계 유형(논의, 소개, 확장 등)
  • 메모리 그래프와의 통합

필수 조건

이 시스템은 지속적인 지식 그래프 저장을 위해 MCP 메모리 서버 와 통합됩니다.

빠른 시작

  1. 스키마를 사용하여 새로운 SQLite 데이터베이스를 만듭니다.

지엑스피1

  1. 소스 관리 서버를 설치하세요.
# Install for Claude Desktop with your database path fastmcp install source-manager-server.py --name "Source Manager" -e SQLITE_DB_PATH=/path/to/sources.db

개요

핵심 테이블

-- Sources table CREATE TABLE sources ( id UUID PRIMARY KEY, title TEXT NOT NULL, type TEXT CHECK(type IN ('paper', 'webpage', 'book', 'video', 'blog')) NOT NULL, identifiers JSONB NOT NULL, status TEXT CHECK(status IN ('unread', 'reading', 'completed', 'archived')) DEFAULT 'unread' ); -- Source notes CREATE TABLE source_notes ( source_id UUID REFERENCES sources(id), note_title TEXT NOT NULL, content TEXT NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (source_id, note_title) ); -- Entity links CREATE TABLE source_entity_links ( source_id UUID REFERENCES sources(id), entity_name TEXT, relation_type TEXT CHECK(relation_type IN ('discusses', 'introduces', 'extends', 'evaluates', 'applies', 'critiques')), notes TEXT, PRIMARY KEY (source_id, entity_name) );

사용 예

1. 소스 관리

여러 식별자가 있는 논문을 추가합니다.

add_source( title="Attention Is All You Need", type="paper", identifier_type="arxiv", identifier_value="1706.03762", initial_note={ "title": "Initial thoughts", "content": "Groundbreaking paper introducing transformers..." } ) # Add another identifier to the same paper add_identifier( title="Attention Is All You Need", type="paper", current_identifier_type="arxiv", current_identifier_value="1706.03762", new_identifier_type="semantic_scholar", new_identifier_value="204e3073870fae3d05bcbc2f6a8e263d9b72e776" )

웹페이지 추가:

add_source( title="Understanding Transformers", type="webpage", identifier_type="url", identifier_value="https://example.com/transformers", )

2. 노트 필기

소스에 메모 추가:

add_note( title="Attention Is All You Need", type="paper", identifier_type="arxiv", identifier_value="1706.03762", note_title="Implementation details", note_content="The paper describes the architecture..." )

3. 엔티티 연결

엔터티에 대한 링크 소스:

link_to_entity( title="Attention Is All You Need", type="paper", identifier_type="arxiv", identifier_value="1706.03762", entity_name="transformer", relation_type="introduces", notes="First paper to introduce the transformer architecture" )

엔터티별 쿼리 소스:

get_entity_sources( entity_name="transformer", type_filter="paper", relation_filter="discusses" )

모범 사례

  1. 소스 관리
    • 참조문헌 전체에서 일관된 제목을 사용하세요
    • 가능한 한 많은 식별자를 제공하세요
    • 명확한 제목으로 노트를 체계적으로 정리하세요
    • 적절한 소스 유형을 사용하세요
  2. 엔티티 연결
    • 관계 유형을 구체적으로 지정하세요
    • 관계에 상황별 메모 추가
    • 메모리 그래프에 대해 엔터티 이름 확인
    • 엔터티 관계를 집중적으로 유지하세요

기술적 세부 사항

  1. 소스 식별
    • 일관된 참조를 위한 내부 UUID 시스템
    • 소스당 여러 개의 외부 식별자
    • 유연한 식별자 유형(arxiv, doi, url 등)
    • 제목 및 유형 기반 퍼지 매칭
  2. 데이터 구성
    • 제목이 있는 구조화된 노트
    • 명확한 소스 유형 분류
    • 엔터티 관계 추적
    • 상태 관리

기여하다

  1. 저장소를 포크하세요
  2. 기능 브랜치 생성
  3. 새로운 기능에 대한 테스트 추가
  4. 풀 리퀘스트 제출
-
security - not tested
A
license - permissive license
-
quality - not tested

Claude와의 원활한 상호 작용을 위해 설계된 체계적인 노트 작성 및 정리 기능을 갖춘 학술 문헌 관리 서버입니다. 간편성과 이동성을 위해 SQLite로 구축되었습니다.

  1. Features
    1. Core Features
    2. Entity Integration
  2. Prerequisites
    1. Quick Start
      1. Schema
        1. Core Tables
      2. Usage Examples
        1. 1. Managing Sources
        2. 2. Note Taking
        3. 3. Entity Linking
      3. Best Practices
        1. Technical Details
          1. Contributing
            ID: lgobt6htp7