iflow-mcp-yuzongmin-sqlite-literature-management-fastmcp-mcp-server 0.1.3__py3-none-any.whl

iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.data/data/share/source_manager_pkg/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zongmin Yu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.data/data/share/source_manager_pkg/README.md

@@ -0,0 +1,191 @@
+# Universal Source Management System
+
+A flexible system for managing various types of sources (papers, books, webpages, etc.) and integrating them with knowledge graphs.
+
+## Features
+
+### Core Features
+
+- Universal source identification with internal UUID system
+- Support for multiple source types (papers, webpages, books, videos, blogs)
+- Multiple identifier support per source (arxiv, DOI, semantic scholar, ISBN, URL)
+- Structured note-taking with titles and content
+- Status tracking (unread, reading, completed, archived)
+
+### Entity Integration
+
+- Link sources to knowledge graph entities
+- Track relationships between sources and entities
+- Flexible relation types (discusses, introduces, extends, etc.)
+- Integration with memory graph
+
+## Prerequisites
+
+This system integrates with the [MCP Memory Server](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) for persistent knowledge graph storage.
+
+## Quick Start
+
+1. Create a new SQLite database with our schema:
+
+```bash
+# Create a new database
+sqlite3 sources.db < create_sources_db.sql
+```
+
+2. Install the source management server:
+
+```bash
+# 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
+```
+
+## Schema
+
+### Core Tables
+
+```sql
+-- 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)
+);
+```
+
+## Usage Examples
+
+### 1. Managing Sources
+
+Add a paper with multiple identifiers:
+
+```python
+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 a webpage:
+
+```python
+add_source(
+    title="Understanding Transformers",
+    type="webpage",
+    identifier_type="url",
+    identifier_value="https://example.com/transformers",
+)
+```
+
+### 2. Note Taking
+
+Add notes to a source:
+
+```python
+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. Entity Linking
+
+Link source to entities:
+
+```python
+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"
+)
+```
+
+Query sources by entity:
+
+```python
+get_entity_sources(
+    entity_name="transformer",
+    type_filter="paper",
+    relation_filter="discusses"
+)
+```
+
+## Best Practices
+
+1. Source Management
+
+   - Use consistent titles across references
+   - Provide as many identifiers as available
+   - Keep notes structured with clear titles
+   - Use appropriate source types
+
+2. Entity Linking
+   - Be specific with relation types
+   - Add contextual notes to relationships
+   - Verify entity names against memory graph
+   - Keep entity relationships focused
+
+## Technical Details
+
+1. Source Identification
+
+   - Internal UUID system for consistent referencing
+   - Multiple external identifiers per source
+   - Flexible identifier types (arxiv, doi, url, etc.)
+   - Title and type based fuzzy matching
+
+2. Data Organization
+   - Structured notes with titles
+   - Clear source type categorization
+   - Entity relationship tracking
+   - Status management
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new features
+4. Submit a pull request

iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.data/data/share/source_manager_pkg/create_sources_db.sql

@@ -0,0 +1,32 @@
+-- Core sources table
+CREATE TABLE sources (
+    id TEXT PRIMARY KEY,  -- Using TEXT for UUID storage
+    title TEXT NOT NULL,
+    type TEXT CHECK(type IN ('paper', 'webpage', 'book', 'video', 'blog')) NOT NULL,
+    identifiers TEXT NOT NULL,  -- JSON string storing {type: value} pairs
+    status TEXT CHECK(status IN ('unread', 'reading', 'completed', 'archived')) DEFAULT 'unread'
+);
+
+-- Notes with titles for better organization
+CREATE TABLE source_notes (
+    source_id TEXT 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 remain essential for knowledge graph integration
+CREATE TABLE source_entity_links (
+    source_id TEXT 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)
+);
+
+-- Create indexes for better performance
+CREATE INDEX idx_sources_type ON sources(type);
+CREATE INDEX idx_sources_status ON sources(status);
+CREATE INDEX idx_source_notes_created ON source_notes(created_at);
+CREATE INDEX idx_entity_links_name ON source_entity_links(entity_name);

iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/METADATA

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: iflow-mcp-yuzongmin-sqlite-literature-management-fastmcp-mcp-server
+Version: 0.1.3
+Summary: A flexible system for managing various types of sources (papers, books, webpages, etc.) and integrating them with knowledge graphs
+Requires-Python: >=3.8
+Requires-Dist: fastmcp>=0.1.0
+Description-Content-Type: text/markdown
+
+# Universal Source Management System
+
+A flexible system for managing various types of sources (papers, books, webpages, etc.) and integrating them with knowledge graphs.
+
+## Features
+
+### Core Features
+
+- Universal source identification with internal UUID system
+- Support for multiple source types (papers, webpages, books, videos, blogs)
+- Multiple identifier support per source (arxiv, DOI, semantic scholar, ISBN, URL)
+- Structured note-taking with titles and content
+- Status tracking (unread, reading, completed, archived)
+
+### Entity Integration
+
+- Link sources to knowledge graph entities
+- Track relationships between sources and entities
+- Flexible relation types (discusses, introduces, extends, etc.)
+- Integration with memory graph
+
+## Prerequisites
+
+This system integrates with the [MCP Memory Server](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) for persistent knowledge graph storage.
+
+## Quick Start
+
+1. Create a new SQLite database with our schema:
+
+```bash
+# Create a new database
+sqlite3 sources.db < create_sources_db.sql
+```
+
+2. Install the source management server:
+
+```bash
+# 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
+```
+
+## Schema
+
+### Core Tables
+
+```sql
+-- 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)
+);
+```
+
+## Usage Examples
+
+### 1. Managing Sources
+
+Add a paper with multiple identifiers:
+
+```python
+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 a webpage:
+
+```python
+add_source(
+    title="Understanding Transformers",
+    type="webpage",
+    identifier_type="url",
+    identifier_value="https://example.com/transformers",
+)
+```
+
+### 2. Note Taking
+
+Add notes to a source:
+
+```python
+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. Entity Linking
+
+Link source to entities:
+
+```python
+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"
+)
+```
+
+Query sources by entity:
+
+```python
+get_entity_sources(
+    entity_name="transformer",
+    type_filter="paper",
+    relation_filter="discusses"
+)
+```
+
+## Best Practices
+
+1. Source Management
+
+   - Use consistent titles across references
+   - Provide as many identifiers as available
+   - Keep notes structured with clear titles
+   - Use appropriate source types
+
+2. Entity Linking
+   - Be specific with relation types
+   - Add contextual notes to relationships
+   - Verify entity names against memory graph
+   - Keep entity relationships focused
+
+## Technical Details
+
+1. Source Identification
+
+   - Internal UUID system for consistent referencing
+   - Multiple external identifiers per source
+   - Flexible identifier types (arxiv, doi, url, etc.)
+   - Title and type based fuzzy matching
+
+2. Data Organization
+   - Structured notes with titles
+   - Clear source type categorization
+   - Entity relationship tracking
+   - Status management
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new features
+4. Submit a pull request

iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/RECORD

@@ -0,0 +1,14 @@
+source_manager_pkg/LICENSE,sha256=3Yjua4f62AxnTsuGEUl2EgieD9gLOXYYtfRyXWyJcbU,1067
+source_manager_pkg/README.md,sha256=463R3S4KNgooiWZ7FUvwYeYQ_uyrfhjOJLQaVq52jfc,4726
+source_manager_pkg/TODO.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+source_manager_pkg/__init__.py,sha256=xRHtuRyhbl8E-fYWo1aIdYBR02wcWjtcOMGLW99e91I,59757
+source_manager_pkg/create_sources_db.sql,sha256=1t_-3KLsAr4yh6iR1tB0rjR1tKygv-zcSgRKIj6Ox4w,1286
+source_manager_pkg/memory.jsonl,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+source_manager_pkg/sources.db,sha256=xfjg-kX8IWql-0OTYM5eLCgIb2jPkSjSUTBhpKFm8Y4,45056
+iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.data/data/share/source_manager_pkg/LICENSE,sha256=3Yjua4f62AxnTsuGEUl2EgieD9gLOXYYtfRyXWyJcbU,1067
+iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.data/data/share/source_manager_pkg/README.md,sha256=463R3S4KNgooiWZ7FUvwYeYQ_uyrfhjOJLQaVq52jfc,4726
+iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.data/data/share/source_manager_pkg/create_sources_db.sql,sha256=1t_-3KLsAr4yh6iR1tB0rjR1tKygv-zcSgRKIj6Ox4w,1286
+iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/METADATA,sha256=xgDfnIvQfe6z6tOoZl8BDWEkEF0I2cA5u2gbsof8L5I,5071
+iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/entry_points.txt,sha256=GwZUtV8IrSYWlS2SLv8TfXCVzNaKGS4nE0aZKWAmrqg,59
+iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/RECORD,,

iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_yuzongmin_sqlite_literature_management_fastmcp_mcp_server-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+source-manager = source_manager_pkg:main

source_manager_pkg/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zongmin Yu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

source_manager_pkg/README.md

@@ -0,0 +1,191 @@
+# Universal Source Management System
+
+A flexible system for managing various types of sources (papers, books, webpages, etc.) and integrating them with knowledge graphs.
+
+## Features
+
+### Core Features
+
+- Universal source identification with internal UUID system
+- Support for multiple source types (papers, webpages, books, videos, blogs)
+- Multiple identifier support per source (arxiv, DOI, semantic scholar, ISBN, URL)
+- Structured note-taking with titles and content
+- Status tracking (unread, reading, completed, archived)
+
+### Entity Integration
+
+- Link sources to knowledge graph entities
+- Track relationships between sources and entities
+- Flexible relation types (discusses, introduces, extends, etc.)
+- Integration with memory graph
+
+## Prerequisites
+
+This system integrates with the [MCP Memory Server](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) for persistent knowledge graph storage.
+
+## Quick Start
+
+1. Create a new SQLite database with our schema:
+
+```bash
+# Create a new database
+sqlite3 sources.db < create_sources_db.sql
+```
+
+2. Install the source management server:
+
+```bash
+# 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
+```
+
+## Schema
+
+### Core Tables
+
+```sql
+-- 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)
+);
+```
+
+## Usage Examples
+
+### 1. Managing Sources
+
+Add a paper with multiple identifiers:
+
+```python
+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 a webpage:
+
+```python
+add_source(
+    title="Understanding Transformers",
+    type="webpage",
+    identifier_type="url",
+    identifier_value="https://example.com/transformers",
+)
+```
+
+### 2. Note Taking
+
+Add notes to a source:
+
+```python
+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. Entity Linking
+
+Link source to entities:
+
+```python
+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"
+)
+```
+
+Query sources by entity:
+
+```python
+get_entity_sources(
+    entity_name="transformer",
+    type_filter="paper",
+    relation_filter="discusses"
+)
+```
+
+## Best Practices
+
+1. Source Management
+
+   - Use consistent titles across references
+   - Provide as many identifiers as available
+   - Keep notes structured with clear titles
+   - Use appropriate source types
+
+2. Entity Linking
+   - Be specific with relation types
+   - Add contextual notes to relationships
+   - Verify entity names against memory graph
+   - Keep entity relationships focused
+
+## Technical Details
+
+1. Source Identification
+
+   - Internal UUID system for consistent referencing
+   - Multiple external identifiers per source
+   - Flexible identifier types (arxiv, doi, url, etc.)
+   - Title and type based fuzzy matching
+
+2. Data Organization
+   - Structured notes with titles
+   - Clear source type categorization
+   - Entity relationship tracking
+   - Status management
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new features
+4. Submit a pull request