# kimi-api-mcp

MCP server for [Kimi K2.5](https://platform.moonshot.ai) via the Moonshot REST API — **no CLI installation or subscription required**. Just a Moonshot API key.

Works with Claude Code, Cursor, VS Code, Windsurf, Claude Desktop, and any MCP-compatible host.

[![CI](https://github.com/bene-bosco/kimi-api-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/bene-bosco/kimi-api-mcp/actions/workflows/ci.yml)
[![npm](https://img.shields.io/npm/v/kimi-api-mcp)](https://www.npmjs.com/package/kimi-api-mcp)

## Why

The official [`kimi-code-mcp`](https://www.npmjs.com/package/kimi-code-mcp) package requires the Kimi Code CLI binary and a paid subscription. This package calls the Moonshot API directly using your existing API key — no binary, no subscription.

## Install

No install needed with `npx`:

```bash
npx kimi-api-mcp@latest
```

Or install globally:

```bash
npm install -g kimi-api-mcp
```

## Setup

1. Get an API key from [platform.moonshot.ai](https://platform.moonshot.ai) (free tier available)
2. Add to your MCP config

### Claude Code (`~/.claude/mcp.json`)

```json
{
  "mcpServers": {
    "kimi-code": {
      "command": "npx",
      "args": ["-y", "kimi-api-mcp@latest"],
      "env": {
        "MOONSHOT_API_KEY": "your-moonshot-api-key"
      }
    }
  }
}
```

### Cursor (`.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "kimi": {
      "command": "npx",
      "args": ["-y", "kimi-api-mcp@latest"],
      "env": {
        "MOONSHOT_API_KEY": "your-moonshot-api-key"
      }
    }
  }
}
```

### VS Code / Windsurf

Add the same `mcpServers` block to your MCP settings file.

## Tools

### Local tier — free, no LLM calls

| Tool | Description |
|------|-------------|
| `kimi_read_file` | Read a text file (with offset/limit) |
| `kimi_write_file` | Create or overwrite a file |
| `kimi_edit_file` | Find-and-replace in a file |
| `kimi_glob` | Find files matching a glob pattern |
| `kimi_grep` | Search files with regex (uses `rg` or `grep`) |
| `kimi_shell` | Execute a shell command (120s timeout) |
| `kimi_fetch_url` | Fetch and extract text from a URL |

### Moonshot API tier — uses `moonshot-v1-128k` (~$0.60/M tokens)

| Tool | Description |
|------|-------------|
| `kimi_think` | Extended step-by-step reasoning |
| `kimi_review` | Code review (bugs, security, performance) |
| `kimi_test` | Generate or improve tests |
| `kimi_research` | Analyze a codebase with 128K context |
| `kimi_read_media` | Analyze images via vision API |
| `kimi_web_search` | Web search + AI summary |
| `kimi_agent` | Autonomous multi-step agent (up to 15 iterations) |

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `MOONSHOT_API_KEY` | Yes | Your Moonshot API key from [platform.moonshot.ai](https://platform.moonshot.ai) |

## Requirements

- Node.js 18+
- A Moonshot API key (for API-tier tools)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

MIT — see [LICENSE](LICENSE).