Extreme P Value MCP Server

🚀 MCP Server for Extreme P-value Calculation

This MCP server provides an API interface through Python to call the extreme p-value calculation functions (z, t, F, chi-square, SAIGE, excluding the Wald method) implemented in the R script extreme-P.R.

🚀 Quick Start

This MCP server offers an API to call extreme p-value calculation functions implemented in an R script. Here's a brief overview of how it works and how to get started.

Prerequisites

• R script extreme-P.R: The server heavily depends on this R script (except for the Wald method).
• pyper: Used to call R from Python.
• FastMCP: The API server is built with FastMCP.
• extreme_p_helper.py: A wrapper corresponding to R functions one by one.
• server.py: Provides API endpoints.

✨ Features

• Function Call: Call extreme p-value calculation functions (z, t, F, chi-square, SAIGE) implemented in the R script extreme-P.R through the API.
• Python-R Interaction: Use pyper to call R functions from Python.
• FastMCP Server: Built with FastMCP to provide API services.

📦 Installation

Dependencies

• uv
• pyper
• fastmcp
• mcp[cli]

Directory Structure

+.
├── server.py              # Main FastMCP server file
├── extreme_p_helper.py    # R function wrapper
├── extreme-P.R            # R script implementing extreme p-value calculation (see Acknowledgments)
├── pyproject.toml         # Dependency management
└── README.md              # This document

Setup and Run

Add the MCP Server to Your MCP Server List (e.g., Claude, Cursor, etc.)

{
    "mcpServers": {
      "ExtremeP": {
        "command": "uv",
        "args": ["--directory", "The location where you cloned the code", "run", "server.py"],
        "env": {}
      }
    }
}

Run the MCP Checker

# Install dependencies
uv sync

# Run the MCP checker
uv --directory ./ run mcp dev server.py

Run the MCP Server

# Install dependencies
uv sync

# Run the MCP server
uv run server.py

💻 Usage Examples

Basic Usage

from extreme_p_helper import ExtremePHelper
helper = ExtremePHelper()
result = helper.pvalue_extreme_z(10)
print(result)  # {'mantissa': ..., 'exponent': ...}

📚 Documentation

Current Status

🚧 Under Active Development 🚧

This project is under active development. The API and features may change without prior notice.

📄 License

This MCP server is released under the Apache License 2.0.

Acknowledgments

• skoyamamd and carbocation
• pyper
• FastMCP