all-in-mcp 0.2.5

An MCP (Model Context Protocol) server providing daily-use utility functions and academic paper search capabilities

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)

pip install all-in-mcp

Option 2: Install from Source

1. Clone this repository:

   git clone https://github.com/jiahaoxiang2000/all-in-mcp.git
   cd all-in-mcp
   

2. Install with UV:

   uv sync
   

Running the Server

After installation, you can run the MCP server directly:

all-in-mcp

Or if you installed from source with UV:

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.

Example configuration for Claude Desktop:

{
  "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.

Quick Development Setup

# 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:

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:

   version = "0.1.2"  # Change this
   

2. Commit and tag:

   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:

npx @modelcontextprotocol/inspector uv --directory /path/to/all-in-mcp run all-in-mcp

Documentation

Complete documentation is available in the docs/ directory:

• API Reference - Complete API documentation
• Installation Guide - Setup instructions
• IACR Integration - Academic paper search details
• CryptoBib Integration - Bibliography database search
• Development Guide - Contributing guidelines
• PyPI Setup Guide - Publishing configuration
• Examples - Usage examples