Metadata-Version: 2.5
Name: cape-mcp
Version: 0.1.0
Summary: Model Context Protocol (MCP) server for CAPE Sandbox
Project-URL: Homepage, https://github.com/CAPESandbox/CAPE-mcp
Project-URL: Repository, https://github.com/CAPESandbox/CAPE-mcp.git
Author-email: Kevin O'Reilly <kev@capesandbox.com>, doomedraven <doomedraven@capesandbox.com>
License: MIT
Requires-Python: >=3.9
Requires-Dist: fastmcp
Requires-Dist: httpx
Description-Content-Type: text/markdown

# CAPE MCP Server

A standalone [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for interacting with [CAPE Sandbox](https://github.com/CAPESandbox/CAPEv2). This allows LLMs and agents to directly query CAPE Sandbox APIs.

## Installation

```bash
pip install cape-mcp
```

## Configuration

The server requires environment variables to connect to your CAPE Sandbox instance.

*   `CAPE_API_URL`: The URL of your CAPE Sandbox API v2 (e.g., `http://127.0.0.1:8000/apiv2`).
*   `CAPE_API_TOKEN`: Your API token (if authentication is enabled).
*   `CAPE_API_TOKEN_REQUIRED`: Set to `true` if your CAPE instance enforces API tokens globally.
*   `CAPE_ENABLED_MCP_TOOLS`: (Optional) A comma-separated list of tools to enable. By default, all are enabled.

## Usage

You can run the server directly:

```bash
export CAPE_API_URL="http://127.0.0.1:8000/apiv2"
export CAPE_API_TOKEN="your_token_here"
cape-mcp
```

### Claude Desktop

To use this with Claude Desktop, add it to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "cape-sandbox": {
      "command": "cape-mcp",
      "env": {
        "CAPE_API_URL": "http://127.0.0.1:8000/apiv2",
        "CAPE_API_TOKEN": "your_token_here"
      }
    }
  }
}
```