Sqlite Literature Management Fastmcp MCP Server

🚀 通用来源管理系统

通用来源管理系统是一个灵活的系统，可用于管理各种类型的来源，如论文、书籍、网页等，并能将这些来源与知识图谱集成，为知识管理提供便利。

🚀 快速开始

1. 使用我们的架构创建新的 SQLite 数据库：

# 创建新数据库
sqlite3 sources.db < create_sources_db.sql

2. 安装来源管理服务器：

# 为 Claude Desktop 安装，指定数据库路径
fastmcp install source-manager-server.py --name "Source Manager" -e SQLITE_DB_PATH=/path/to/sources.db

✨ 主要特性

核心功能

• 采用内部 UUID 系统，为来源提供统一标识符。
• 支持多种来源类型，涵盖论文、网页、书籍、视频、博客。
• 每个来源可拥有多个标识符，如 arxiv、DOI、Semantic Scholar、ISBN、URL。
• 提供结构化笔记管理，笔记包含标题和内容。
• 可跟踪来源状态，状态包括未读、阅读中、已完成、已归档。

实体集成

• 能将来源链接到知识图谱实体。
• 跟踪来源与实体之间的关系。
• 支持灵活的关系类型，如讨论、介绍、扩展、评估等。
• 可与记忆图集成。

📦 安装指南

本系统与 MCP 记忆服务器 集成，用于持久化知识图谱存储。

💻 使用示例

基础用法

# 添加一个简单的论文来源
add_source("标题", "paper")

# 显示所有来源
view_sources()

高级用法

# 添加带有多个标识符的来源
add_source(
    title="标题",
    type="paper",
    identifiers={
        "arxiv": "1234.5678",
        "doi": "10.xxxx/1234"
    },
    status="unread"
)

# 显示特定来源的详细信息
view_source("source_id_1")

# 显示来源的笔记
view_notes("source_id_1")

📚 详细文档

数据库架构

核心表结构

-- 来源表
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'
);

-- 来源笔记
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)
);

-- 实体链接
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', 'assesses', 'assesses', 'assesses')),
    PRIMARY KEY (source_id, entity_name)
);

🔧 技术细节

核心特性

• 统一标识符：使用内部 UUID 系统为每个来源生成唯一标识符。
• 多种类型支持：包括论文、网页、书籍、视频和博客等多种来源类型。
• 多标识符支持：每个来源可以拥有多个标识符，如 arxiv、DOI、Semantic Scholar、ISBN 和 URL。
• 状态管理：跟踪来源的状态，包括未读、阅读中、已完成和已归档。

数据组织

• 结构化笔记管理，每条笔记都有标题和内容。
• 按照来源类型进行分类。
• 跟踪来源与知识图谱实体之间的关系。
• 管理来源状态的变更。

🤝 贡献指南

1. fork 仓库
2. 创建功能分支
3. 添加新功能的测试
4. 提交 pull request