all-in-mcp 0.1.4__tar.gz → 0.2.3__tar.gz

{all_in_mcp-0.1.4 → all_in_mcp-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: all-in-mcp
-Version: 0.1.4
+Version: 0.2.3
 Summary: An MCP (Model Context Protocol) server providing daily-use utility functions and academic paper search capabilities
 Project-URL: Homepage, https://github.com/jiahaoxiang2000/all-in-mcp
 Project-URL: Repository, https://github.com/jiahaoxiang2000/all-in-mcp
@@ -52,14 +52,25 @@ An MCP (Model Context Protocol) server that provides daily-use utility functions
 ### Daily Utilities
 
 - **Academic Research**: IACR ePrint Archive paper search, download, and reading
+- **Bibliography Search**: CryptoBib database search for cryptography papers
+- **PDF Reading**: Read and extract text from local and online PDF files
 
 ### Paper Search Capabilities
 
+#### IACR ePrint Archive
+
 - Search academic papers from IACR ePrint Archive
 - Download PDF files
 - Extract and read text content from papers
 - Metadata extraction (authors, publication dates, abstracts)
 
+#### CryptoBib Database
+
+- Search comprehensive cryptography bibliography database
+- Access to thousands of cryptographic research papers
+- Retrieve structured paper metadata or raw BibTeX entries
+- Support for all major cryptography venues and conferences
+
 ## Quick Start
 
 ### Prerequisites
@@ -75,7 +86,7 @@ An MCP (Model Context Protocol) server that provides daily-use utility functions
 pip install all-in-mcp
 ```
 
-### Installation
+### Option 2: Install from Source
 
 1. Clone this repository:
 
@@ -201,6 +212,7 @@ Complete documentation is available in the [`docs/`](docs/) directory:
 - **[API Reference](docs/api.md)** - Complete API documentation
 - **[Installation Guide](docs/installation.md)** - Setup instructions
 - **[IACR Integration](docs/iacr.md)** - Academic paper search details
+- **[CryptoBib Integration](docs/cryptobib.md)** - Bibliography database search
 - **[Development Guide](docs/development.md)** - Contributing guidelines
 - **[PyPI Setup Guide](docs/pypi-setup.md)** - Publishing configuration
 - **[Examples](docs/examples.md)** - Usage examples

{all_in_mcp-0.1.4 → all_in_mcp-0.2.3}/README.md

@@ -7,14 +7,25 @@ An MCP (Model Context Protocol) server that provides daily-use utility functions
 ### Daily Utilities
 
 - **Academic Research**: IACR ePrint Archive paper search, download, and reading
+- **Bibliography Search**: CryptoBib database search for cryptography papers
+- **PDF Reading**: Read and extract text from local and online PDF files
 
 ### Paper Search Capabilities
 
+#### IACR ePrint Archive
+
 - Search academic papers from IACR ePrint Archive
 - Download PDF files
 - Extract and read text content from papers
 - Metadata extraction (authors, publication dates, abstracts)
 
+#### CryptoBib Database
+
+- Search comprehensive cryptography bibliography database
+- Access to thousands of cryptographic research papers
+- Retrieve structured paper metadata or raw BibTeX entries
+- Support for all major cryptography venues and conferences
+
 ## Quick Start
 
 ### Prerequisites
@@ -30,7 +41,7 @@ An MCP (Model Context Protocol) server that provides daily-use utility functions
 pip install all-in-mcp
 ```
 
-### Installation
+### Option 2: Install from Source
 
 1. Clone this repository:
 
@@ -156,6 +167,7 @@ Complete documentation is available in the [`docs/`](docs/) directory:
 - **[API Reference](docs/api.md)** - Complete API documentation
 - **[Installation Guide](docs/installation.md)** - Setup instructions
 - **[IACR Integration](docs/iacr.md)** - Academic paper search details
+- **[CryptoBib Integration](docs/cryptobib.md)** - Bibliography database search
 - **[Development Guide](docs/development.md)** - Contributing guidelines
 - **[PyPI Setup Guide](docs/pypi-setup.md)** - Publishing configuration
 - **[Examples](docs/examples.md)** - Usage examples

{all_in_mcp-0.1.4 → all_in_mcp-0.2.3}/docs/api.md

@@ -108,6 +108,61 @@ URL: https://eprint.iacr.org/2023/1234
 [Full extracted text content]
 ```
 
+## CryptoBib Bibliography Search
+
+### search-cryptobib-papers
+
+Search CryptoBib bibliography database for cryptography papers. CryptoBib is a comprehensive BibTeX database of cryptography-related academic papers.
+
+**Parameters:**
+
+- `query` (string, required): Search query string (e.g., 'cryptography', 'lattice', 'homomorphic')
+- `max_results` (integer, optional): Maximum number of results to return (default: 10)
+- `return_bibtex` (boolean, optional): Whether to return raw BibTeX entries (default: false)
+- `force_download` (boolean, optional): Force download the newest crypto.bib file (default: false)
+
+**Returns:**
+
+- List of papers with metadata or raw BibTeX entries
+
+**Example:**
+
+```json
+{
+  "name": "search-cryptobib-papers",
+  "arguments": {
+    "query": "lattice cryptography",
+    "max_results": 5,
+    "return_bibtex": true,
+    "force_download": false
+  }
+}
+```
+
+**Response:**
+
+````text
+Found 5 BibTeX entries for query 'lattice cryptography':
+
+Entry 1:
+```bibtex
+@InProceedings{CRYPTO:RegLyr05,
+  author = "Oded Regev and Ricky Steinfeld",
+  title = "Learning With Errors over Rings",
+  booktitle = "CRYPTO 2005",
+  year = 2005,
+  ...
+}
+````
+
+**Important Notes:**
+
+- **First Use**: On first use, the tool will download the crypto.bib file (~50MB) and cache it locally in the `./downloads` directory
+- **Caching**: Subsequent searches use the cached file unless `force_download` is set to true
+- **BibTeX Retrieval**: To get specific BibTeX entries, use the `search-cryptobib-papers` tool with `return_bibtex=true` and a specific search query
+- **Content**: The crypto.bib file contains thousands of cryptography-related papers from major conferences and journals
+- **Performance**: Local file searching is much faster than streaming searches
+
 ## Error Handling
 
 All tools return error messages in case of failures:

all_in_mcp-0.2.3/docs/cryptobib.md

@@ -0,0 +1,166 @@
+# CryptoBib Integration
+
+This document describes the CryptoBib integration in the all-in-mcp server.
+
+## Overview
+
+CryptoBib (https://cryptobib.di.ens.fr/) is a comprehensive bibliography database for cryptography research papers. This integration allows searching through the CryptoBib database and retrieving BibTeX entries.
+
+## Features
+
+### Search Functionality
+
+- Search through the entire CryptoBib database
+- Case-insensitive search across all BibTeX fields
+- Returns both parsed Paper objects and raw BibTeX entries
+- Configurable result limits
+
+### BibTeX Support
+
+- Parse BibTeX entries into structured Paper objects
+- Retrieve raw BibTeX entries for direct use
+- Support for all standard BibTeX fields (author, title, booktitle, journal, year, etc.)
+- Clean LaTeX formatting from titles and authors
+
+## Available Tools
+
+### search-cryptobib-papers
+
+Search CryptoBib bibliography database for cryptography papers.
+
+**Parameters:**
+
+- `query` (required): Search query string (e.g., 'lattice', 'homomorphic encryption')
+- `max_results` (optional, default: 10): Maximum number of results to return
+- `return_bibtex` (optional, default: false): Whether to return raw BibTeX entries
+- `force_download` (optional, default: false): Force download the newest crypto.bib file
+
+**Examples:**
+
+```json
+{
+  "query": "lattice cryptography",
+  "max_results": 5,
+  "return_bibtex": false
+}
+```
+
+To get specific BibTeX entries, you can use targeted search queries with `return_bibtex=true`.
+
+## Usage Examples
+
+### Basic Search
+
+```python
+from all_in_mcp.academic_platforms.cryptobib import CryptoBibSearcher
+
+searcher = CryptoBibSearcher()
+
+# Search for papers
+papers = searcher.search("homomorphic encryption", max_results=5)
+for paper in papers:
+    print(f"Title: {paper.title}")
+    print(f"Authors: {', '.join(paper.authors)}")
+    print(f"BibTeX Key: {paper.paper_id}")
+```
+
+### Get Raw BibTeX
+
+```python
+# Get raw BibTeX entries
+bibtex_entries = searcher.search_bibtex("zero knowledge", max_results=3)
+for entry in bibtex_entries:
+    print(entry)
+```
+
+### Get Specific BibTeX Entry
+
+```python
+# Search for specific entries using targeted queries
+papers = searcher.search("ACISP:LZXSW24", max_results=1)
+if papers:
+    # Access the BibTeX from the paper's extra field
+    bibtex = papers[0].extra.get('bibtex', '')
+    print(bibtex)
+
+# Or get raw BibTeX entries directly
+bibtex_entries = searcher.search_bibtex("ACISP:LZXSW24", max_results=1)
+if bibtex_entries:
+    print(bibtex_entries[0])
+```
+
+## BibTeX Entry Format
+
+CryptoBib uses standard BibTeX format. Example entry:
+
+```bibtex
+@InProceedings{ACISP:LZXSW24,
+  author =       "Fangzhou Liu and
+                  Xueqi Zhu and
+                  Ruozhou Xu and
+                  Danping Shi and
+                  Peng Wang",
+  title =        "The Offline Quantum Attack Against Modular Addition Variant of {Even}-{Mansour} Cipher",
+  pages =        "3--19",
+  editor =       acisp24ed,
+  booktitle =    acisp24name1,
+  volume =       acisp24vol1,
+  address =      acisp24addr,
+  month =        acisp24month,
+  publisher =    acisp24pub,
+  series =       mylncs,
+  year =         2024,
+  doi =          "10.1007/978-981-97-5025-2_1",
+}
+```
+
+## Implementation Details
+
+### Search Strategy
+
+The implementation uses streaming HTTP requests to search through the large crypto.bib file without downloading it entirely. It:
+
+1. Makes a streaming request to the crypto.bib file
+2. Parses BibTeX entries on-the-fly
+3. Performs case-insensitive matching against the search query
+4. Returns results as they are found up to the specified limit
+
+### Performance Considerations
+
+- Uses streaming to avoid memory issues with the large bibliography file
+- Processes entries incrementally
+- Stops searching once the maximum number of results is reached
+- Implements proper brace counting for correct BibTeX entry parsing
+
+### Limitations
+
+- No PDF download capability (CryptoBib is a bibliography database only)
+- No full-text search of paper content
+- Search is limited to BibTeX field content
+- Dependent on CryptoBib server availability
+
+## Testing
+
+Run the CryptoBib tests:
+
+```bash
+# Run all tests
+pytest tests/test_cryptobib.py
+
+# Run with verbose output
+pytest tests/test_cryptobib.py -v
+
+# Test specific functionality
+python test_cryptobib.py
+```
+
+## Error Handling
+
+The implementation includes comprehensive error handling for:
+
+- Network connectivity issues
+- Malformed BibTeX entries
+- Server response errors
+- Parsing failures
+
+All errors are logged and gracefully handled, returning empty results or error messages as appropriate.

{all_in_mcp-0.1.4 → all_in_mcp-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "all-in-mcp"
-version = "0.1.4"
+version = "0.2.3"
 description = "An MCP (Model Context Protocol) server providing daily-use utility functions and academic paper search capabilities"
 readme = "README.md"
 license = { text = "MIT" }

all_in_mcp-0.2.3/src/all_in_mcp/academic_platforms/__init__.py

@@ -0,0 +1,6 @@
+# all_in_mcp/academic_platforms/__init__.py
+from .base import PaperSource
+from .cryptobib import CryptoBibSearcher
+from .iacr import IACRSearcher
+
+__all__ = ["CryptoBibSearcher", "IACRSearcher", "PaperSource"]