All-in-MCP

Provides utility functions for common tasks like text processing, encoding, decoding, hashing, and system information.

View on GitHub →

All-in-MCP

A FastMCP-based Model Context Protocol (MCP) server providing academic paper search and PDF processing utilities. Features a modular architecture with both proxy and standalone server capabilities.

APaper Research Direction

Architecture

All-in-MCP uses a modern FastMCP architecture with two main components:

  1. 🔄 All-in-MCP Proxy Server: Main server that routes requests to academic tools
  2. 📚 APaper Module: Isolated academic research server with specialized paper search tools

This design provides better modularity, performance, and scalability.

Features

Both servers expose academic paper search tools as FastMCP endpoints with automatic tool registration:

Available Tools

CategoryTool NameDescriptionBackend
Academic Researchapaper_search_iacr_papersSearch academic papers from IACR ePrint ArchiveAPaper
apaper_download_iacr_paperDownload PDF of an IACR ePrint paperAPaper
apaper_read_iacr_paperRead and extract text content from an IACR ePrint paper PDFAPaper
Bibliography Searchapaper_search_cryptobib_papersSearch CryptoBib bibliography database for cryptography papersAPaper
Cross-platform Searchapaper_search_crossref_papersSearch academic papers from Crossref databaseAPaper
apaper_search_google_scholar_papersSearch academic papers across disciplines with citation dataAPaper
PDF Processingapaper_read_pdf_fileRead and extract text from local and online PDF filesAPaper
GitHub Repositorygithub-repo-mcp_getRepoAllDirectoriesGet all directories from a GitHub repositoryGitHub-Repo-MCP
github-repo-mcp_getRepoDirectoriesGet directories from a specific path in GitHub repositoryGitHub-Repo-MCP
github-repo-mcp_getRepoFileGet file content from GitHub repositoryGitHub-Repo-MCP

All tools are implemented using FastMCP decorators with automatic registration, built-in validation, and enhanced error handling.

Quick Start

Prerequisites

  • Python 3.10 or higher
  • pipx for Python package installation
  • npx for MCP Inspector (Node.js required)

Integration with MCP Clients

Add the servers to your MCP client configuration:

VSCode Configuration (.vscode/mcp.json)

{
  "servers": {
    "all-in-mcp": {
      "type": "stdio",
      "command": "pipx",
      "args": ["run", "all-in-mcp"],
      "env": {
        "APAPER": "true",
        "GITHUB_REPO_MCP": "true"
      }
    }
  }
}

Claude Code Configuration (.mcp.json)

{
  "mcpServers": {
    "all-in-mcp": {
      "type": "stdio",
      "command": "pipx",
      "args": ["run", "all-in-mcp"],
      "env": {
        "APAPER": "true",
        "GITHUB_REPO_MCP": "true"
      }
    }
  }
}

Server Options

The main proxy server supports multiple MCP backends through environment variables:

# Run with APaper academic tools enabled
APAPER=true pipx run all-in-mcp

# Run with GitHub repository tools enabled
GITHUB_REPO_MCP=true pipx run all-in-mcp

# Run with both backends enabled
APAPER=true GITHUB_REPO_MCP=true pipx run all-in-mcp

# Run standalone APaper server (academic tools only)
pipx run apaper

Note: If you have the package installed globally, you can also run directly: all-in-mcp or apaper

Debugging & Testing

MCP Inspector

Use the official MCP Inspector to debug and test server functionality:

# Debug the main proxy server with APaper tools
APAPER=true npx @modelcontextprotocol/inspector pipx run all-in-mcp

# Debug with all backends enabled
APAPER=true GITHUB_REPO_MCP=true npx @modelcontextprotocol/inspector pipx run all-in-mcp

# Debug standalone APaper server
npx @modelcontextprotocol/inspector pipx run apaper

The MCP Inspector provides:

  • 🔍 Interactive Tool Testing: Test all available tools with real parameters
  • 📊 Server Information: View server capabilities and tool schemas
  • 🐛 Debug Messages: Monitor server communication and error messages
  • ⚡ Real-time Testing: Execute tools and see results immediately

Perfect for development, debugging, and understanding how the FastMCP tools work.

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 (now using unittest)
uv run python tests/test_fastmcp_server.py
uv run python tests/test_apaper_iacr.py
uv run python tests/test_apaper_pdf.py

Related Servers