Metadata-Version: 2.4
Name: snail-mcp
Version: 0.1.2
Summary: General-purpose MCP server (Excel read and more).
Requires-Python: >=3.13
Requires-Dist: mcp
Requires-Dist: openpyxl
Description-Content-Type: text/markdown

# snail-mcp

General-purpose MCP server.

## Setup

```bash
uv sync
```

## Run MCP server

After `uv sync`, use either:

```bash
uv run snail-mcp
```

or (with venv activated) run the script directly:

```bash
snail-mcp
```

Alternative: `uv run python -m snail_mcp.server`

## Run via uvx

```bash
uvx snail-mcp
```

If you see `ImportError: cannot import name 'main' from 'mcp.server'`, the cached package is old. Clear cache then retry:

```bash
uv cache clean snail-mcp
uvx snail-mcp
```

## Publish

1. Build: `uv build`
2. Upload: `uv publish` (need PyPI token) or `twine upload dist/*`
3. Then anyone can run: `uvx snail-mcp`

## Tools

- **read_excel**: Read .xlsx cells (value, formula, style). Params: filepath, out (v/b/f/n/z/c/g), fmt (j/t), sheets, row/col range, sparse.

---

*This README was generated by AI.*
