# Kitsune MCP

> Kitsune MCP is an open-source MCP server for developer tools. Hot-reload an MCP server you are building and mount community servers mid-session. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://kaiser-data.github.io/kitsune-mcp/
- **Repository:** https://github.com/kaiser-data/kitsune-mcp
- **MCP Registry name:** io.github.kaiser-data/kitsune-mcp
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

The problem Kitsune solves is narrow: an agent edits an MCP tool, but the client keeps running the old process until someone restarts it. Here connect, call and reload are themselves tools, so the agent can start a server, change the code, call reload on it and re-run the tool in the same session.

The second function is borrowing. A search tool queries 7 registries covering 130,000+ servers, shapeshift mounts a single tool rather than a whole server, and shapeshift with no arguments drops it again. An auth tool can add an API key mid-session. When Docker is installed, npm and PyPI community packages run in a locked-down container; your own server run through connect is a plain local process and does not need Docker.

The site is candid about when to skip it: with only 1 to 3 trusted servers, configure them directly. Without client tool deferral it costs roughly 1,774 tokens per turn, and a cold mount takes 1 to 15 seconds. It needs Python 3.12 or newer and uv, and installs with uvx kitsune-mcp.

## Features

- **Hot reload:** Restarts your server on fresh code and remounts it without restarting the client.
- **Registry search:** Searches 7 registries covering 130,000+ servers.
- **Single-tool mounting:** Mounts one tool from a server instead of all of them.
- **Docker cage:** Runs npm and PyPI community packages in a hardened container when Docker is present.
- **Mid-session credentials:** Adds an API key during a session.
- **Version pins and confirmation:** Requires explicit confirmation to run community code.

## Good for

- Let an agent fix and retest its own MCP tool without a client restart
- Try a scraping server once without editing config
- Run an unfamiliar PDF tool package in a container
- Develop a local server with connect and reload

## Install

### Claude Code (Terminal)

```sh
claude mcp add kitsune-mcp --env SMITHERY_API_KEY='<SMITHERY_API_KEY>' -- npx -y kitsune-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kitsune-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kitsune-mcp"
      ],
      "env": {
        "SMITHERY_API_KEY": "<SMITHERY_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kitsune-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kitsune-mcp"
      ],
      "env": {
        "SMITHERY_API_KEY": "<SMITHERY_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kitsune-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kitsune-mcp"
      ],
      "env": {
        "SMITHERY_API_KEY": "<SMITHERY_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kitsune-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kitsune-mcp"
      ],
      "env": {
        "SMITHERY_API_KEY": "<SMITHERY_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kitsune-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kitsune-mcp"
      ],
      "env": {
        "SMITHERY_API_KEY": "<SMITHERY_API_KEY>"
      }
    }
  }
}
```

## Tools

- `connect`: Starts your own MCP server as a local process.
- `shapeshift`: Mounts a server's tools, or just selected ones, into the session; with no arguments it drops them.
- `call`: Calls a mounted tool.
- `reload`: Restarts a connected server on fresh code and remounts it.
- `search`: Searches MCP registries for servers.
- `auth`: Saves a credential such as an API key mid-session.

## FAQ

### Do I need Docker?

No. Hot-reload of your own server never needs it; Docker only cages community packages.

### What are the requirements?

Python 3.12+, uv, and node/npx for npm-based servers.

### Which clients does it work with?

Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Zed and others.

### Does it cost tokens?

Without tool deferral, about 1,774 tokens per turn, per the site.

### Is a key required?

No. SMITHERY_API_KEY is optional and only adds Smithery to registry search.

### Is Kitsune MCP free?

Yes. Kitsune MCP is open source, so you can use and self-host it for free.

### How do I add Kitsune MCP to Claude Code?

Run this command in your terminal: claude mcp add kitsune-mcp --env SMITHERY_API_KEY='<SMITHERY_API_KEY>' -- npx -y kitsune-mcp

### What are the best alternatives to Kitsune MCP?

The closest alternatives to Kitsune MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/kitsune-mcp
