Metadata-Version: 2.4
Name: hank-excel-mcp
Version: 0.1.0
Summary: MCP server, relay backend, and tool registry for Excel add-ins
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi
Requires-Dist: uvicorn
Requires-Dist: httpx<0.29,>=0.27
Requires-Dist: fastmcp<4,>=3.2.4
Requires-Dist: mcp
Requires-Dist: python-dotenv
Requires-Dist: cryptography>=42

# hank-excel-mcp

Python package for connecting Excel to AI via MCP.

See the [main README](../README.md) for full documentation.

## Install

```bash
pip install hank-excel-mcp==0.1.0
```

The distribution is `hank-excel-mcp`; the Python import remains `excel_mcp`
and the console command remains `excel-mcp`. For package development, use
`pip install -e .` from this directory instead.

## Components

- `excel_mcp.mcp_server` — MCP stdio server (`python -m excel_mcp`)
- `excel_mcp.relay` — relay state and `create_relay_app()` factory; an embedding
  application must supply request authentication
- `excel_mcp.tool_registry` — built-in workbook tools plus `register_tools()` extensibility
- `excel_mcp.mcp_server.channel_status` — relay/taskpane health and recovery inspection

The live MCP server currently exposes 26 tools: `channel_status` plus the
registry-backed workbook tools. Inspect the registered surface in process when
changing either owner.

`excel-mcp start` is a host-repository convenience command that launches
`api.main:app`; it is not a standalone authenticated relay. Portable consumers
should embed `create_relay_app()` with their own request authenticator.
