Metadata-Version: 2.5
Name: kedi-mcp
Version: 0.1.0
Summary: MCP server for Kedi
Project-URL: Repository, https://github.com/kedi-lang/kedi-mcp
Project-URL: Issues, https://github.com/kedi-lang/kedi-mcp/issues
Author: Mert Sırakaya, Doğukan Yiğit Polat
Author-email: mert@kedi-lang.org, yigit@neurograph.net
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: fastmcp==3.4.7
Requires-Dist: kedi<0.2,>=0.1.5
Requires-Dist: pydantic<2.15,>=2.14.3
Description-Content-Type: text/markdown

# kedi-mcp

`kedi-mcp` exposes stable Kedi core workflows through a FastMCP server.

## Install

```bash
uv tool install kedi-mcp
```

To work from source, run the installer from a Kedi workspace with this repository checked out as
`kedi-mcp/`:

```bash
./kedi-mcp/install.sh
```

The installer uses `uv` if available. If `uv` is missing, it installs `uv` with the
official installer, then installs both `kedi` and `kedi-mcp` as user-level tool
entries.

For a standalone clone of this repository, point the installer at a compatible
Kedi source checkout instead of its default parent directory:

```bash
KEDI_INSTALL_SPEC=/path/to/kedi ./install.sh
```

Requires Python 3.11+ and Kedi `>=0.1.5,<0.2`. The installer creates user-level
tool environments; it does not install into the currently activated virtual
environment.

## Run

```bash
kedi-mcp
```

By default the server runs over stdio for MCP clients.

```json
{
  "mcpServers": {
    "kedi": {
      "command": "kedi-mcp"
    }
  }
}
```

Use the executable's absolute path if the client does not inherit your shell's
`PATH`. Run it only for trusted clients: execution tools can run embedded
Python and use the server process's filesystem access and credentials. This
server is not a sandbox.

## Tools

- `kedi_health`: report server readiness and executable discovery.
- `kedi_parse`: parse source text or a `.kedi` file and return a stable program summary.
- `kedi_compile`: parse and compile source without constructing an LLM adapter.
- `kedi_schema`: return JSON schemas for Kedi procedures.
- `kedi_run`: run source text or a file path.
- `kedi_test`: run `@test` blocks from a `.kedi` file.
- `kedi_eval`: run `@eval` blocks from a `.kedi` file.

Tool names intentionally use underscores for broad MCP client compatibility.
