all-in-mcp 0.2.5__tar.gz → 0.2.7__tar.gz

all_in_mcp-0.2.7/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: all-in-mcp
+Version: 0.2.7
+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
+Project-URL: Documentation, https://github.com/jiahaoxiang2000/all-in-mcp/tree/main/docs
+Project-URL: Issues, https://github.com/jiahaoxiang2000/all-in-mcp/issues
+Author-email: isomo <jiahaoxiang2000@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: academic,iacr,mcp,model-context-protocol,papers,utilities
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: General
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: feedparser>=6.0.10
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: mcp>=1.9.4
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: requests>=2.31.0
+Provides-Extra: all
+Requires-Dist: psutil>=5.9.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: twine>=4.0.0; extra == 'dev'
+Provides-Extra: system
+Requires-Dist: psutil>=5.9.0; extra == 'system'
+Description-Content-Type: text/markdown
+
+# All-in-MCP
+
+An MCP (Model Context Protocol) server that provides utility functions, including academic paper search capabilities.
+
+- [**Paper Tools overview _Video_**](https://www.bilibili.com/video/BV1RMKWzdEk8)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/setup.pdf)
+
+## Features
+
+This MCP server exposes the following daily-use utility tools as MCP endpoints:
+
+### Available Tools
+
+- **Academic Research**:
+  - `search-iacr-papers`: Search academic papers from IACR ePrint Archive
+  - `download-iacr-paper`: Download PDF of an IACR ePrint paper
+  - `read-iacr-paper`: Read and extract text content from an IACR ePrint paper PDF
+- **Bibliography Search**:
+  - `search-cryptobib-papers`: Search CryptoBib bibliography database for cryptography papers (structured metadata or raw BibTeX)
+- **Crossref Search**:
+  - `search-crossref-papers`: Search academic papers from Crossref database
+- **Google Scholar**:
+  - `search-google-scholar-papers`: Search academic papers across disciplines with citation data
+- **PDF Reading**:
+  - `read-pdf`: Read and extract text from local and online PDF files
+
+All tools are implemented as async MCP endpoints with proper validation and error handling.
+
+## Quick Start
+
+- [**Video for Env Setup**](https://www.bilibili.com/video/BV1cZKozaEjg)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/config.pdf)
+
+### Prerequisites
+
+- Python 3.10 or higher
+- UV package manager
+
+### Installation
+
+Install from PyPI (Recommended by `UV`)
+
+```bash
+uv pip install all-in-mcp
+```
+
+### Integration with MCP Clients Vscode
+
+Add this server to your MCP client configuration. The server runs using stdio transport.
+
+Example configuration for Vscode:
+
+```json .vscode/mcp.json
+{
+  "servers": {
+    "all-in-mcp": {
+      "type": "stdio",
+      "command": "uv",
+      "args": ["run", "all-in-mcp"]
+    }
+  }
+}
+```
+
+<details>
+<summary>Development</summary>
+
+For development setup and contribution guidelines, see the [Development Guide](docs/development.md).
+
+### Quick Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
+cd all-in-mcp
+
+# Install with development dependencies
+uv sync --extra dev
+
+# Run tests
+uv run pytest
+```
+
+</details>

all_in_mcp-0.2.7/README.md

@@ -0,0 +1,84 @@
+# All-in-MCP
+
+An MCP (Model Context Protocol) server that provides utility functions, including academic paper search capabilities.
+
+- [**Paper Tools overview _Video_**](https://www.bilibili.com/video/BV1RMKWzdEk8)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/setup.pdf)
+
+## Features
+
+This MCP server exposes the following daily-use utility tools as MCP endpoints:
+
+### Available Tools
+
+- **Academic Research**:
+  - `search-iacr-papers`: Search academic papers from IACR ePrint Archive
+  - `download-iacr-paper`: Download PDF of an IACR ePrint paper
+  - `read-iacr-paper`: Read and extract text content from an IACR ePrint paper PDF
+- **Bibliography Search**:
+  - `search-cryptobib-papers`: Search CryptoBib bibliography database for cryptography papers (structured metadata or raw BibTeX)
+- **Crossref Search**:
+  - `search-crossref-papers`: Search academic papers from Crossref database
+- **Google Scholar**:
+  - `search-google-scholar-papers`: Search academic papers across disciplines with citation data
+- **PDF Reading**:
+  - `read-pdf`: Read and extract text from local and online PDF files
+
+All tools are implemented as async MCP endpoints with proper validation and error handling.
+
+## Quick Start
+
+- [**Video for Env Setup**](https://www.bilibili.com/video/BV1cZKozaEjg)
+- [_Overview PDF_](https://github.com/jiahaoxiang2000/tutor/blob/main/Apaper/config.pdf)
+
+### Prerequisites
+
+- Python 3.10 or higher
+- UV package manager
+
+### Installation
+
+Install from PyPI (Recommended by `UV`)
+
+```bash
+uv pip install all-in-mcp
+```
+
+### Integration with MCP Clients Vscode
+
+Add this server to your MCP client configuration. The server runs using stdio transport.
+
+Example configuration for Vscode:
+
+```json .vscode/mcp.json
+{
+  "servers": {
+    "all-in-mcp": {
+      "type": "stdio",
+      "command": "uv",
+      "args": ["run", "all-in-mcp"]
+    }
+  }
+}
+```
+
+<details>
+<summary>Development</summary>
+
+For development setup and contribution guidelines, see the [Development Guide](docs/development.md).
+
+### Quick Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
+cd all-in-mcp
+
+# Install with development dependencies
+uv sync --extra dev
+
+# Run tests
+uv run pytest
+```
+
+</details>

{all_in_mcp-0.2.5 → all_in_mcp-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "all-in-mcp"
-version = "0.2.5"
+version = "0.2.7"
 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.5 → all_in_mcp-0.2.7}/src/all_in_mcp/academic_platforms/crossref.py

@@ -224,87 +224,15 @@ class CrossrefSearcher(PaperSource):
 
     def download_pdf(self, paper_id: str, save_path: str) -> str:
         """
-        Download PDF for a paper (limited functionality for Crossref)
-
-        Note: Crossref is primarily a metadata service. PDF downloads
-        depend on publisher policies and may not always be available.
+        Not implemented: Download PDF for a paper (limited functionality for Crossref)
         """
-        if not paper_id:
-            return "Error: paper_id is required"
-
-        try:
-            # If paper_id is a DOI, try to get work details first
-            if not paper_id.startswith("http"):
-                work_url = f"{self.WORKS_ENDPOINT}/{quote_plus(paper_id)}"
-                response = self.client.get(work_url, headers=self._get_headers())
-                response.raise_for_status()
-
-                work_data = response.json()
-                work = work_data.get("message", {})
-
-                # Look for PDF link
-                links = work.get("link", [])
-                pdf_url = None
-                for link in links:
-                    if link.get("content-type") == "application/pdf":
-                        pdf_url = link.get("URL")
-                        break
-
-                if not pdf_url:
-                    return f"Error: No PDF link found for DOI {paper_id}. Crossref provides metadata; PDFs are hosted by publishers."
-            else:
-                pdf_url = paper_id
-
-            # Attempt to download PDF
-            from pathlib import Path
-
-            save_path_obj = Path(save_path)
-            save_path_obj.mkdir(parents=True, exist_ok=True)
-
-            # Create filename from DOI or URL
-            if paper_id.startswith("10."):
-                filename = (
-                    f"crossref_{paper_id.replace('/', '_').replace('.', '_')}.pdf"
-                )
-            else:
-                filename = f"crossref_paper_{hash(paper_id) % 10000}.pdf"
-
-            file_path = save_path_obj / filename
-
-            pdf_response = self.client.get(pdf_url, headers=self._get_headers())
-            pdf_response.raise_for_status()
-
-            with open(file_path, "wb") as f:
-                f.write(pdf_response.content)
-
-            return str(file_path)
-
-        except Exception as e:
-            return f"Error downloading PDF: {e}"
+        return "Crossref does not provide a direct way to download PDFs. Use the paper's URL or DOI to access the publisher's site for PDF downloads if available."
 
     def read_paper(self, paper_id: str, save_path: str) -> str:
         """
-        Read paper text (downloads PDF first if needed)
-
-        Note: Success depends on PDF availability from publishers
+        crossref doesn't provide a direct way to read paper text.
         """
-        if not paper_id:
-            return "Error: paper_id is required"
-
-        try:
-            # First try to download the PDF
-            pdf_path = self.download_pdf(paper_id, save_path)
-
-            if pdf_path.startswith("Error"):
-                return pdf_path
-
-            # Read the PDF using the existing read_pdf function
-            from ..paper import read_pdf
-
-            return read_pdf(pdf_path)
-
-        except Exception as e:
-            return f"Error reading paper: {e}"
+        return "Crossref does not provide a direct way to read paper text. Use the download_pdf method to get the PDF if available."
 
     def search_by_doi(self, doi: str) -> Optional[Paper]:
         """Search for a specific paper by DOI"""

{all_in_mcp-0.2.5 → all_in_mcp-0.2.7}/src/all_in_mcp/academic_platforms/iacr.py

@@ -141,7 +141,12 @@ class IACRSearcher(PaperSource):
             return None
 
     def search(
-        self, query: str, max_results: int = 10, fetch_details: bool = True
+        self,
+        query: str,
+        max_results: int = 10,
+        fetch_details: bool = True,
+        year_min: int | None = None,
+        year_max: int | None = None,
     ) -> list[Paper]:
         """
         Search IACR ePrint Archive
@@ -150,6 +155,8 @@ class IACRSearcher(PaperSource):
             query: Search query string
             max_results: Maximum number of results to return
             fetch_details: Whether to fetch detailed information for each paper (slower but more complete)
+            year_min: Minimum publication year (revised after)
+            year_max: Maximum publication year (revised before)
 
         Returns:
             List[Paper]: List of paper objects
@@ -158,7 +165,11 @@ class IACRSearcher(PaperSource):
 
         try:
             # Construct search parameters
-            params = {"q": query}
+            params: dict[str, str | int] = {"q": query}
+            if year_min:
+                params["revisedafter"] = year_min
+            if year_max:
+                params["revisedbefore"] = year_max
 
             # Make request
             response = self.session.get(self.IACR_SEARCH_URL, params=params)

{all_in_mcp-0.2.5 → all_in_mcp-0.2.7}/src/all_in_mcp/server.py

@@ -47,6 +47,14 @@ async def handle_list_tools() -> list[types.Tool]:
                         "description": "Whether to fetch detailed information for each paper (default: True)",
                         "default": True,
                     },
+                    "year_min": {
+                        "type": "integer",
+                        "description": "Minimum publication year (revised after)",
+                    },
+                    "year_max": {
+                        "type": "integer",
+                        "description": "Maximum publication year (revised before)",
+                    },
                 },
                 "required": ["query"],
             },
@@ -185,44 +193,6 @@ async def handle_list_tools() -> list[types.Tool]:
                 "required": ["query"],
             },
         ),
-        types.Tool(
-            name="download-crossref-paper",
-            description="Download PDF of a Crossref paper (when available from publisher)",
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "paper_id": {
-                        "type": "string",
-                        "description": "DOI or URL of the paper",
-                    },
-                    "save_path": {
-                        "type": "string",
-                        "description": "Directory to save the PDF (default: './downloads')",
-                        "default": "./downloads",
-                    },
-                },
-                "required": ["paper_id"],
-            },
-        ),
-        types.Tool(
-            name="read-crossref-paper",
-            description="Read and extract text content from a Crossref paper PDF",
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "paper_id": {
-                        "type": "string",
-                        "description": "DOI or URL of the paper",
-                    },
-                    "save_path": {
-                        "type": "string",
-                        "description": "Directory where the PDF is/will be saved (default: './downloads')",
-                        "default": "./downloads",
-                    },
-                },
-                "required": ["paper_id"],
-            },
-        ),
         types.Tool(
             name="read-pdf",
             description="Read and extract text content from a PDF file (local or online)",
@@ -255,6 +225,8 @@ async def handle_call_tool(
             query = arguments.get("query", "")
             max_results = arguments.get("max_results", 10)
             fetch_details = arguments.get("fetch_details", True)
+            year_min = arguments.get("year_min")
+            year_max = arguments.get("year_max")
 
             if not query:
                 return [
@@ -263,17 +235,34 @@ async def handle_call_tool(
                     )
                 ]
 
-            papers = iacr_searcher.search(query, max_results, fetch_details)
+            papers = iacr_searcher.search(
+                query,
+                max_results=max_results,
+                fetch_details=fetch_details,
+                year_min=year_min,
+                year_max=year_max,
+            )
 
             if not papers:
+                year_filter_msg = ""
+                if year_min or year_max:
+                    year_range = f" ({year_min or 'earliest'}-{year_max or 'latest'})"
+                    year_filter_msg = f" in year range{year_range}"
                 return [
                     types.TextContent(
-                        type="text", text=f"No papers found for query: {query}"
+                        type="text",
+                        text=f"No papers found for query: {query}{year_filter_msg}",
                     )
                 ]
 
             # Format the results
-            result_text = f"Found {len(papers)} IACR papers for query '{query}':\n\n"
+            year_filter_msg = ""
+            if year_min or year_max:
+                year_range = f" ({year_min or 'earliest'}-{year_max or 'latest'})"
+                year_filter_msg = f" in year range{year_range}"
+            result_text = (
+                f"Found {len(papers)} IACR papers for query '{query}'{year_filter_msg}:\n\n"
+            )
             for i, paper in enumerate(papers, 1):
                 result_text += f"{i}. **{paper.title}**\n"
                 result_text += f"   - Paper ID: {paper.paper_id}\n"
@@ -586,54 +575,6 @@ async def handle_call_tool(
                     )
                 ]
 
-        elif name == "download-crossref-paper":
-            paper_id = arguments.get("paper_id", "")
-            save_path = arguments.get("save_path", "./downloads")
-
-            if not paper_id:
-                return [
-                    types.TextContent(
-                        type="text", text="Error: paper_id parameter is required"
-                    )
-                ]
-
-            result = crossref_searcher.download_pdf(paper_id, save_path)
-
-            if result.startswith("Error"):
-                return [types.TextContent(type="text", text=result)]
-            else:
-                return [
-                    types.TextContent(
-                        type="text", text=f"PDF downloaded successfully to: {result}"
-                    )
-                ]
-
-        elif name == "read-crossref-paper":
-            paper_id = arguments.get("paper_id", "")
-            save_path = arguments.get("save_path", "./downloads")
-
-            if not paper_id:
-                return [
-                    types.TextContent(
-                        type="text", text="Error: paper_id parameter is required"
-                    )
-                ]
-
-            result = crossref_searcher.read_paper(paper_id, save_path)
-
-            if result.startswith("Error"):
-                return [types.TextContent(type="text", text=result)]
-            else:
-                # Truncate very long text for display
-                if len(result) > 5000:
-                    truncated_result = (
-                        result[:5000]
-                        + f"\n\n... [Text truncated. Full text is {len(result)} characters long]"
-                    )
-                    return [types.TextContent(type="text", text=truncated_result)]
-                else:
-                    return [types.TextContent(type="text", text=result)]
-
         elif name == "read-pdf":
             pdf_source = arguments.get("pdf_source", "")
 

all_in_mcp-0.2.5/PKG-INFO

@@ -1,226 +0,0 @@
-Metadata-Version: 2.4
-Name: all-in-mcp
-Version: 0.2.5
-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
-Project-URL: Documentation, https://github.com/jiahaoxiang2000/all-in-mcp/tree/main/docs
-Project-URL: Issues, https://github.com/jiahaoxiang2000/all-in-mcp/issues
-Author-email: isomo <jiahaoxiang2000@gmail.com>
-License: MIT
-License-File: LICENSE
-Keywords: academic,iacr,mcp,model-context-protocol,papers,utilities
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Text Processing :: General
-Requires-Python: >=3.10
-Requires-Dist: beautifulsoup4>=4.12.0
-Requires-Dist: feedparser>=6.0.10
-Requires-Dist: httpx>=0.24.0
-Requires-Dist: mcp>=1.9.4
-Requires-Dist: pypdf>=4.0.0
-Requires-Dist: requests>=2.31.0
-Provides-Extra: all
-Requires-Dist: psutil>=5.9.0; extra == 'all'
-Provides-Extra: dev
-Requires-Dist: build>=1.0.0; extra == 'dev'
-Requires-Dist: mypy>=1.5.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
-Requires-Dist: pytest>=8.0.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
-Requires-Dist: twine>=4.0.0; extra == 'dev'
-Provides-Extra: system
-Requires-Dist: psutil>=5.9.0; extra == 'system'
-Description-Content-Type: text/markdown
-
-# All-in-MCP
-
-An MCP (Model Context Protocol) server that provides daily-use utility functions, including academic paper search capabilities.
-
-## Features
-
-### Daily Utilities
-
-- **Academic Research**: IACR ePrint Archive paper search, download, and reading
-- **Bibliography Search**: CryptoBib database search for cryptography papers
-- **Google Scholar**: Search academic papers across disciplines with citation data
-- **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
-
-#### Google Scholar
-
-- Search academic papers across multiple disciplines
-- Access to citation counts and publication metadata
-- Broad coverage of academic literature from various sources
-- Year-based filtering for targeted searches
-
-## Quick Start
-
-### Prerequisites
-
-- Python 3.12 or higher
-- UV package manager
-
-## Installation
-
-### Option 1: Install from PyPI (Recommended)
-
-```bash
-pip install all-in-mcp
-```
-
-### Option 2: Install from Source
-
-1. Clone this repository:
-
-   ```bash
-   git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
-   cd all-in-mcp
-   ```
-
-2. Install with UV:
-
-   ```bash
-   uv sync
-   ```
-
-### Running the Server
-
-After installation, you can run the MCP server directly:
-
-```bash
-all-in-mcp
-```
-
-Or if you installed from source with UV:
-
-```bash
-uv run all-in-mcp
-```
-
-## Integration with MCP Clients
-
-Add this server to your MCP client configuration. The server runs using stdio transport.
-See detailed integration guide in [`docs/INTEGRATION.md`](docs/INTEGRATION.md).
-
-Example configuration for Claude Desktop:
-
-```json
-{
-  "mcpServers": {
-    "all-in-mcp": {
-      "command": "uv",
-      "args": ["run", "all-in-mcp"],
-      "cwd": "/path/to/all-in-mcp"
-    }
-  }
-}
-```
-
-## Development
-
-For development setup and contribution guidelines, see the [Development Guide](docs/development.md).
-
-### Quick Development Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
-cd all-in-mcp
-
-# Install with development dependencies
-uv sync --extra dev
-
-# Run tests
-uv run pytest
-
-# Run linting
-uv run ruff check src/
-uv run ruff format src/
-
-# Type checking
-uv run mypy src/all_in_mcp
-```
-
-### Releases
-
-This project uses the existing release helper script for creating releases:
-
-#### Using the Release Script
-
-Use the release helper script to create a new version:
-
-```bash
-python scripts/release.py 0.1.2
-```
-
-This script will:
-
-1. Update the version in `pyproject.toml`
-2. Create a git commit
-3. Create a git tag
-4. Push the changes to trigger CI/CD
-
-#### Manual Process
-
-Alternatively, you can manually:
-
-1. **Update version** in `pyproject.toml`:
-
-   ```toml
-   version = "0.1.2"  # Change this
-   ```
-
-2. **Commit and tag**:
-
-   ```bash
-   git add pyproject.toml
-   git commit -m "Bump version to 0.1.2"
-   git tag v0.1.2
-   git push --follow-tags
-   ```
-
-### Debugging
-
-For debugging, use the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
-
-```bash
-npx @modelcontextprotocol/inspector uv --directory /path/to/all-in-mcp run all-in-mcp
-```
-
-## Documentation
-
-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.2.5/README.md

@@ -1,181 +0,0 @@
-# All-in-MCP
-
-An MCP (Model Context Protocol) server that provides daily-use utility functions, including academic paper search capabilities.
-
-## Features
-
-### Daily Utilities
-
-- **Academic Research**: IACR ePrint Archive paper search, download, and reading
-- **Bibliography Search**: CryptoBib database search for cryptography papers
-- **Google Scholar**: Search academic papers across disciplines with citation data
-- **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
-
-#### Google Scholar
-
-- Search academic papers across multiple disciplines
-- Access to citation counts and publication metadata
-- Broad coverage of academic literature from various sources
-- Year-based filtering for targeted searches
-
-## Quick Start
-
-### Prerequisites
-
-- Python 3.12 or higher
-- UV package manager
-
-## Installation
-
-### Option 1: Install from PyPI (Recommended)
-
-```bash
-pip install all-in-mcp
-```
-
-### Option 2: Install from Source
-
-1. Clone this repository:
-
-   ```bash
-   git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
-   cd all-in-mcp
-   ```
-
-2. Install with UV:
-
-   ```bash
-   uv sync
-   ```
-
-### Running the Server
-
-After installation, you can run the MCP server directly:
-
-```bash
-all-in-mcp
-```
-
-Or if you installed from source with UV:
-
-```bash
-uv run all-in-mcp
-```
-
-## Integration with MCP Clients
-
-Add this server to your MCP client configuration. The server runs using stdio transport.
-See detailed integration guide in [`docs/INTEGRATION.md`](docs/INTEGRATION.md).
-
-Example configuration for Claude Desktop:
-
-```json
-{
-  "mcpServers": {
-    "all-in-mcp": {
-      "command": "uv",
-      "args": ["run", "all-in-mcp"],
-      "cwd": "/path/to/all-in-mcp"
-    }
-  }
-}
-```
-
-## Development
-
-For development setup and contribution guidelines, see the [Development Guide](docs/development.md).
-
-### Quick Development Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
-cd all-in-mcp
-
-# Install with development dependencies
-uv sync --extra dev
-
-# Run tests
-uv run pytest
-
-# Run linting
-uv run ruff check src/
-uv run ruff format src/
-
-# Type checking
-uv run mypy src/all_in_mcp
-```
-
-### Releases
-
-This project uses the existing release helper script for creating releases:
-
-#### Using the Release Script
-
-Use the release helper script to create a new version:
-
-```bash
-python scripts/release.py 0.1.2
-```
-
-This script will:
-
-1. Update the version in `pyproject.toml`
-2. Create a git commit
-3. Create a git tag
-4. Push the changes to trigger CI/CD
-
-#### Manual Process
-
-Alternatively, you can manually:
-
-1. **Update version** in `pyproject.toml`:
-
-   ```toml
-   version = "0.1.2"  # Change this
-   ```
-
-2. **Commit and tag**:
-
-   ```bash
-   git add pyproject.toml
-   git commit -m "Bump version to 0.1.2"
-   git tag v0.1.2
-   git push --follow-tags
-   ```
-
-### Debugging
-
-For debugging, use the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
-
-```bash
-npx @modelcontextprotocol/inspector uv --directory /path/to/all-in-mcp run all-in-mcp
-```
-
-## Documentation
-
-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