home / mcp / kia mcp server

KIA MCP Server

Provides a production-grade MCP server that orchestrates code evolution, local code search, package discovery, and pattern learning to accelerate development.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ash-blanc-kia-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "MORPH_API_KEY": "YOUR_MORPH_API_KEY",
        "CHROMA_API_KEY": "YOUR_CHROMA_API_KEY",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY"
      }
    }
  }
}

KIA MCP Server is a production-grade orchestrator that combines four workflow-centric tools to help you evolve code, search local codebases, discover best practices from publicly available packages, and extract reusable patterns. It lets you work with your codebase more efficiently by leveraging best-in-class APIs through a streamlined local server.

How to use

You will interact with the KIA MCP Server through an MCP client. Start by ensuring the server is running locally, then use the four core tools to perform common tasks. Use evolve_code to iteratively improve a function or module and validate quality across multiple dimensions. Use search_local_codebase to ask questions in plain English about your project to locate relevant code quickly. Use search_packages to learn from real-world implementations by exploring code samples and documentation from popular packages. Use learn_pattern to capture successful evolution patterns and apply them to future work.

How to install

Follow these steps to set up the KIA MCP Server on your machine. Prerequisites are Python 3.9+ and Git.

# Prerequisites
# - Python 3.9+
# - Git

Step 1: Clone the server repository

git clone https://github.com/Ash-Blanc/kia-mcp-server.git
cd kia-mcp-server

Step 2: Install dependencies

pip install -r requirements.txt
```
Or, if you prefer using uvx for an improved startup experience:
```bash
uv pip install -r requirements.txt

Step 3: Set up API keys

# Morph API for code merging and semantic search
export MORPH_API_KEY="sk-..."

# Chroma Package Search for package discovery
export CHROMA_API_KEY="ck-..."

# OpenRouter as GEPA/DSPy LLM backend
export OPENROUTER_API_KEY="sk-or-..."

Step 4: Run the server locally

python server.py
# → 🚀 KIA MCP Server starting...
# → Morph API: ✅ Available
# → Chroma API: ✅ Available
# → GEPA (OpenRouter): ✅ Available

Step 5: Verify server readiness

Open a new terminal and confirm the server is responding by checking the status resources once the server is running. You should see indicators for the Morph, Chroma, and GEPA integrations as shown above.

Available tools

evolve_code

Production-ready code evolution with multi-step reasoning and quality validation across correctness, performance, security, readability, and maintainability.

search_local_codebase

Natural language code search using Morph with two-stage retrieval (vector + rerank) returning file paths, line numbers, and relevance scores.

search_packages

Discover and learn from 3,000+ public packages across Python, JavaScript/TypeScript, Go, Ruby, Java, and more, with code examples and documentation links.

learn_pattern

Extract and store successful evolution patterns from previous code changes to apply them automatically in future evolutions.