all-in-mcp 0.1.4__tar.gz

all_in_mcp-0.1.4/.gitignore

@@ -0,0 +1,11 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+downloads/**

all_in_mcp-0.1.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 isomo
+
+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.

all_in_mcp-0.1.4/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: all-in-mcp
+Version: 0.1.4
+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
+
+### Paper Search Capabilities
+
+- Search academic papers from IACR ePrint Archive
+- Download PDF files
+- Extract and read text content from papers
+- Metadata extraction (authors, publication dates, abstracts)
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12 or higher
+- UV package manager
+
+## Installation
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+pip install all-in-mcp
+```
+
+### Installation
+
+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
+- **[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/README.md

@@ -0,0 +1,161 @@
+# 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
+
+### Paper Search Capabilities
+
+- Search academic papers from IACR ePrint Archive
+- Download PDF files
+- Extract and read text content from papers
+- Metadata extraction (authors, publication dates, abstracts)
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12 or higher
+- UV package manager
+
+## Installation
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+pip install all-in-mcp
+```
+
+### Installation
+
+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
+- **[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/docs/api.md

@@ -0,0 +1,155 @@
+# API Reference
+
+Complete API documentation for all tools available in the All-in-MCP server.
+
+## Academic Paper Search
+
+### search-iacr-papers
+
+Search academic papers from IACR ePrint Archive.
+
+**Parameters:**
+
+- `query` (string, required): Search query
+- `max_results` (integer, optional): Maximum number of results (default: 10)
+
+**Returns:**
+
+- List of papers with metadata (title, authors, abstract, URLs)
+
+**Example:**
+
+```json
+{
+  "name": "search-iacr-papers",
+  "arguments": {
+    "query": "zero knowledge",
+    "max_results": 5
+  }
+}
+```
+
+**Response:**
+
+```
+Found 5 IACR papers for query 'zero knowledge':
+
+1. **Paper Title**
+   - Paper ID: 2025/1234
+   - Authors: Author Names
+   - URL: https://eprint.iacr.org/2025/1234
+   - Abstract: Paper abstract...
+```
+
+### download-iacr-paper
+
+Download PDF of an IACR ePrint paper.
+
+**Parameters:**
+
+- `paper_id` (string, required): IACR paper ID (e.g., "2023/1234")
+- `save_path` (string, optional): Directory to save PDF (default: "./downloads")
+
+**Returns:**
+
+- Path to downloaded PDF file
+
+**Example:**
+
+```json
+{
+  "name": "download-iacr-paper",
+  "arguments": {
+    "paper_id": "2023/1234",
+    "save_path": "./downloads"
+  }
+}
+```
+
+**Response:**
+
+```
+PDF downloaded successfully to: ./downloads/iacr_2023_1234.pdf
+```
+
+### read-iacr-paper
+
+Read and extract text content from an IACR ePrint paper PDF.
+
+**Parameters:**
+
+- `paper_id` (string, required): IACR paper ID (e.g., "2023/1234")
+- `save_path` (string, optional): Directory where PDF is saved (default: "./downloads")
+
+**Returns:**
+
+- Extracted text content from the PDF
+
+**Example:**
+
+```json
+{
+  "name": "read-iacr-paper",
+  "arguments": {
+    "paper_id": "2023/1234",
+    "save_path": "./downloads"
+  }
+}
+```
+
+**Response:**
+
+```
+Title: Paper Title
+Authors: Author Names
+Published Date: 2023-XX-XX
+URL: https://eprint.iacr.org/2023/1234
+...
+[Full extracted text content]
+```
+
+## Error Handling
+
+All tools return error messages in case of failures:
+
+**Common Error Types:**
+
+- Invalid parameters
+- Network connectivity issues
+- File system errors
+- API rate limiting
+- Paper not found
+
+**Error Response Format:**
+
+```
+Error executing [tool-name]: [error description]
+```
+
+## Rate Limiting
+
+The server implements reasonable rate limiting to avoid overwhelming academic paper sources:
+
+- IACR ePrint Archive: Respectful crawling with delays
+- PDF downloads: Sequential processing to avoid server overload
+
+## Data Formats
+
+### Paper Object
+
+Papers are returned with the following structure:
+
+```json
+{
+  "paper_id": "2023/1234",
+  "title": "Paper Title",
+  "authors": ["Author 1", "Author 2"],
+  "abstract": "Paper abstract text...",
+  "url": "https://eprint.iacr.org/2023/1234",
+  "pdf_url": "https://eprint.iacr.org/2023/1234.pdf",
+  "published_date": "2023-XX-XX",
+  "source": "iacr",
+  "categories": ["cryptography"],
+  "keywords": ["keyword1", "keyword2"]
+}
+```

all_in_mcp-0.1.4/docs/configuration.md

@@ -0,0 +1,71 @@
+# Configuration Guide
+
+This guide covers configuration options for the All-in-MCP server.
+
+## Environment Variables
+
+```bash
+# Download settings
+DEFAULT_DOWNLOAD_DIR="./downloads"
+
+# IACR settings
+IACR_BASE_URL="https://eprint.iacr.org"
+IACR_MAX_RETRIES=3
+IACR_TIMEOUT=30
+
+# Logging
+LOG_LEVEL="INFO"
+```
+
+## MCP Client Integration
+
+### Claude Desktop Integration
+
+Add to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "all-in-mcp": {
+      "command": "uv",
+      "args": ["run", "--directory", "/path/to/all-in-mcp", "all-in-mcp"],
+      "env": {
+        "LOG_LEVEL": "INFO",
+        "DEFAULT_DOWNLOAD_DIR": "/path/to/downloads"
+      }
+    }
+  }
+}
+```
+
+## IACR Configuration
+
+The IACR platform can be configured with these environment variables:
+
+```bash
+IACR_BASE_URL="https://eprint.iacr.org"
+IACR_MAX_RETRIES=3
+IACR_TIMEOUT=30
+```
+
+## Troubleshooting
+
+### Common Configuration Issues
+
+**Permission Errors**:
+
+- Check download directory permissions
+- Verify user has write access
+
+**Network Issues**:
+
+- Verify proxy settings
+- Check firewall rules
+
+**Performance Issues**:
+
+- Adjust timeout values
+- Check resource limits