Content
# kimi-code-mcp
[](https://www.npmjs.com/package/kimi-code-mcp)
[](https://github.com/userfrm/kimi-code-mcp/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)
MCP server wrapping [Kimi Code CLI](https://github.com/MoonshotAI/kimi-cli) (kimi-k2.5) — 14 tools for filesystem, shell, web, and agent operations.
## Prerequisites
- Node.js >= 18
- [Kimi CLI](https://github.com/MoonshotAI/kimi-cli) installed and authenticated
## Usage with Claude Desktop
Add to your Claude Desktop configuration:
```json
{
"mcpServers": {
"kimi": {
"command": "npx",
"args": ["-y", "kimi-code-mcp@latest"]
}
}
}
```
## Usage with VS Code
Install the Kimi Code MCP server in VS Code:
[<img alt="Install in VS Code" src="https://img.shields.io/badge/VS_Code-Install_Server-0078d4?style=flat-square&logo=visualstudiocode&logoColor=white">](https://insiders.vscode.dev/redirect/mcp/install?name=kimi&inputs=%5B%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22kimi-code-mcp%40latest%22%5D%7D)
Or add to `.vscode/mcp.json`:
```json
{
"servers": {
"kimi": {
"command": "npx",
"args": ["-y", "kimi-code-mcp@latest"]
}
}
}
```
## Tools
| Tool | Description |
|------|-------------|
| `kimi_read_file` | Read a text file (up to 1000 lines) |
| `kimi_read_media` | Analyze images and videos |
| `kimi_write_file` | Create or overwrite a file |
| `kimi_edit_file` | Find-and-replace edit in a file |
| `kimi_glob` | Find files matching a glob pattern |
| `kimi_grep` | Search for regex patterns in files |
| `kimi_shell` | Execute shell commands |
| `kimi_web_search` | Search the web (up to 20 results) |
| `kimi_fetch_url` | Fetch and extract webpage content |
| `kimi_agent` | Autonomous agent for complex tasks |
| `kimi_think` | Extended reasoning and analysis |
| `kimi_review` | Code review (bugs, security, perf, style) |
| `kimi_research` | Research with 256K context window |
| `kimi_test` | Generate or fix tests with edge cases |
## Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| `KIMI_CLI_PATH` | Absolute path to kimi binary | `kimi` (from PATH) |
| `MCP_KIMI_DEBUG` | Enable debug logging to stderr | unset |
## Development
```bash
git clone https://github.com/userfrm/kimi-code-mcp.git
cd kimi-code-mcp
npm install
npm run build
npm test
```
## License
MIT