# mcp-glm-kimi-ollama

**Free & low-cost LLM access for Claude Code** — three MCP servers covering GLM (Zhipu), Kimi (Moonshot) and local Ollama models.

- 🆓 **GLM** — permanently-free `glm-4-flash` via the Zhipu China endpoint
- 🎁 **Kimi** — Moonshot `kimi-k2.6` (new accounts get a ¥15 credit)
- 🖥️ **Ollama** — fully local, private, zero-cost models (e.g. `qwen3:8b`)

All three run over stdio via Node.js — **no Python or uv required** (Windows users often find `python` is just a Store stub).

## Why

Claude Code is powerful, but API costs add up. This project gives you three cheaper/offline "delegates" you can call from Claude Code:

| Provider | Model | Cost | Best for |
|---|---|---|---|
| GLM (Zhipu) | `glm-4-flash` | **free forever** | daily Q&A, translation, code gen |
| Kimi (Moonshot) | `kimi-k2.6` | ¥15 credit on signup | vision (`kimi_read_media`), deep reasoning |
| Ollama (local) | `qwen3:8b` | **free, offline** | privacy, batch, mechanical tasks |

## Quick start

### 1. Kimi MCP (patched for the China endpoint)

```bash
claude mcp add kimi -s user \
  -e MOONSHOT_API_KEY=sk-xxx \
  -- npx -y mcp-glm-kimi-ollama mcp-kimi
```

> ⚠️ **Why the patch matters**: the upstream `kimi-api-mcp` hardcodes the
> international endpoint `api.moonshot.ai` and a retired model
> `moonshot-v1-128k`. China-registered keys return 401 against the wrong host,
> and the old model no longer exists on the CN endpoint. This repo patches both
> (see `src/kimi-server.mjs`), defaulting to `api.moonshot.cn` + `kimi-k2.6`.

### 2. GLM MCP (free)

```bash
claude mcp add glm -s user \
  -e GLM_API_KEY=xxx.yyy \
  -e GLM_BASE_URL=https://open.bigmodel.cn/api/anthropic \
  -e GLM_OFFPEAK_MODEL=glm-4-flash \
  -e GLM_PEAK_MODEL=glm-4-flash \
  -e GLM_CHEAP_MODEL=glm-4-flash \
  -e GLM_DELEGATE=on \
  -- npx -y glm-mcp
```

### 3. Ollama MCP (local, optional)

```bash
winget install Ollama.Ollama
ollama pull qwen3:8b
claude mcp add ollama -s user -e ASK_OLLAMA_MODEL=qwen3:8b -- npx -y @ask-llm/ollama-mcp
```

## Development

```bash
npm install
npm test
```

## Docs

- [docs/glm-mcp.md](docs/glm-mcp.md) — GLM configuration details & troubleshooting
- [docs/kimi-mcp.md](docs/kimi-mcp.md) — Kimi patch rationale, endpoints & models
- [docs/ollama.md](docs/ollama.md) — local Ollama setup, incl. mirror download tips for mainland China

## License

MIT