Metadata-Version: 2.4
Name: carrot-mcp
Version: 0.0.2
Summary: Carrot MCP - A collection of MCP servers
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: carrot-mcp-ds
Requires-Dist: carrot-mcp-nfc
Requires-Dist: carrot-mcp-serial
Provides-Extra: all
Requires-Dist: carrot-mcp-ds; extra == 'all'
Requires-Dist: carrot-mcp-nfc; extra == 'all'
Requires-Dist: carrot-mcp-serial; extra == 'all'
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Provides-Extra: ds
Requires-Dist: carrot-mcp-ds; extra == 'ds'
Provides-Extra: nfc
Requires-Dist: carrot-mcp-nfc; extra == 'nfc'
Provides-Extra: serial
Requires-Dist: carrot-mcp-serial; extra == 'serial'
Description-Content-Type: text/markdown

# Carrot MCP

[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

A collection of MCP (Model Context Protocol) servers for various hardware and data interfaces.

## Installation

### pip

```bash
pip install carrot-mcp
```

This installs all MCP servers (ds, serial, nfc) by default.

### uv

```bash
uv pip install carrot-mcp
```

### Install specific servers only

```bash
# pip or uv
pip install carrot-mcp[ds]
pip install carrot-mcp[serial]
pip install carrot-mcp[nfc]
```

### Or install sub-packages directly

```bash
pip install carrot-mcp-ds
pip install carrot-mcp-serial
pip install carrot-mcp-nfc
```

## Quick Start

### uvx (recommended)

```bash
# Run a specific server directly (no install needed)
uvx carrot-mcp-ds
uvx carrot-mcp-serial
uvx carrot-mcp-nfc
```

### CLI

```bash
# 列出所有可用 server
carrot-mcp list

# 运行指定 server
carrot-mcp ds
carrot-mcp serial
carrot-mcp nfc

# uv 运行
uv run carrot-mcp ds
```

### Python module

```bash
python -m carrot_mcp_ds
python -m carrot_mcp_serial
python -m carrot_mcp_nfc
```

## Available Servers

| Server | Package | Description |
|--------|---------|-------------|
| DS | `carrot-mcp-ds` | Datasheet MCP server |
| Serial | `carrot-mcp-serial` | Serial port MCP server |
| NFC | `carrot-mcp-nfc` | NFC reader MCP server |

## MCP Configuration

Add to your MCP client config (e.g., Claude Desktop):

```json
{
  "mcpServers": {
    "carrot-ds": {
      "command": "uvx",
      "args": ["carrot-mcp-ds"]
    },
    "carrot-serial": {
      "command": "uvx",
      "args": ["carrot-mcp-serial"]
    },
    "carrot-nfc": {
      "command": "uvx",
      "args": ["carrot-mcp-nfc"]
    }
  }
}
```

## Development

```bash
# Clone and setup
git clone <repo-url>
cd carrot-mcp
uv sync --all-packages

# Run tests
uv run pytest

# Bump version and release
bump.bat                        # interactive
bump.bat carrot-mcp-ds          # direct package
```

## License

Apache License 2.0 - see [LICENSE](LICENSE) for details.
