https://github.com/kahliburke/kaimon.jl
MCP server giving AI agents full access to Julia's runtime via a live Gate — code execution, introspection, debugging, testing, and semantic search
https://github.com/kahliburke/kaimon.jl
agent ai claude claude-code cursor debugging developer-tools gemini-cli julia julia-lang llm mcp mcp-server model-context-protocol qdrant repl semantic-search tui vscode zmq
Last synced: 5 days ago
JSON representation
MCP server giving AI agents full access to Julia's runtime via a live Gate — code execution, introspection, debugging, testing, and semantic search
- Host: GitHub
- URL: https://github.com/kahliburke/kaimon.jl
- Owner: kahliburke
- License: mit
- Created: 2026-02-27T08:43:55.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T07:46:44.000Z (16 days ago)
- Last Synced: 2026-04-02T20:16:47.640Z (15 days ago)
- Topics: agent, ai, claude, claude-code, cursor, debugging, developer-tools, gemini-cli, julia, julia-lang, llm, mcp, mcp-server, model-context-protocol, qdrant, repl, semantic-search, tui, vscode, zmq
- Language: Julia
- Homepage: https://kahliburke.github.io/Kaimon.jl/dev/
- Size: 3.72 MB
- Stars: 40
- Watchers: 1
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kaimon.jl
**Opening the gate between AI and Julia.**
[](https://github.com/kahliburke/Kaimon.jl/actions/workflows/CI.yml)
[](https://kahliburke.github.io/Kaimon.jl/dev/)
[](https://julialang.org)
[](LICENSE)
Kaimon is an MCP (Model Context Protocol) server that gives AI agents full access to
Julia's runtime. Connect Claude Code, Cursor, or any MCP client to a live Julia session
with 32+ tools for code execution, introspection, debugging, testing, and semantic
code search.
## Key Features
- **Live Code Execution** — evaluate Julia code in persistent REPL sessions with full
state, package access, and streaming output
- **Deep Introspection** — inspect types, methods, lowered IR, type-inferred code, and
macro expansions directly from the agent
- **The Gate** — connect external Julia processes and register custom tools via ZMQ.
Your app's domain logic becomes agent-callable with automatic schema generation
- **Interactive Debugging** — Infiltrator.jl integration with breakpoints, variable
inspection, and expression evaluation at pause points
- **Semantic Code Search** — index projects into Qdrant and search with natural language
queries like "function that handles HTTP routing"
- **Terminal Dashboard** — real-time TUI monitoring sessions, tool calls, test runs,
and search results across all connected REPLs
- **Security** — three modes (strict/relaxed/lax), API key management, IP allowlists
- **Testing & Profiling** — run tests with pattern filtering and coverage, profile code,
stress-test with concurrent simulated agents
## Quick Start
```julia
]app add Kaimon
```
This installs the `kaimon` command to `~/.julia/bin/` (make sure it's on your `PATH`). Then:
```bash
kaimon
```
The first run opens a setup wizard (security mode, API key, port). After that, the terminal dashboard launches:
From the dashboard:
- Press **`i`** in the Config tab to write MCP config for Claude Code, Cursor, VS Code, or Gemini CLI
- Press **`g`** to add a Gate snippet to `~/.julia/config/startup.jl` so every Julia session auto-connects
- Or connect manually from any REPL: `using Kaimon; Gate.serve()`
## Tool Categories
| Category | Tools | Description |
|----------|-------|-------------|
| Code Execution | `ex`, `manage_repl` | Evaluate code, restart/shutdown sessions |
| Introspection | `investigate_environment`, `search_methods`, `type_info`, `list_names`, `workspace_symbols`, `document_symbols`, `macro_expand` | Explore types, methods, and symbols |
| Code Analysis | `code_lowered`, `code_typed`, `format_code`, `lint_package` | IR inspection, formatting, linting |
| Navigation | `goto_definition`, `navigate_to_file` | Jump to definitions and source locations |
| VS Code | `execute_vscode_command`, `list_vscode_commands` | VS Code command execution |
| Debugging | `debug_ctrl`, `debug_eval`, `debug_exfiltrate`, `debug_inspect_safehouse`, `debug_clear_safehouse` | Infiltrator.jl breakpoint debugging |
| Packages | `pkg_add`, `pkg_rm` | Add/remove packages |
| Testing | `run_tests`, `profile_code`, `stress_test` | Test execution, profiling, load testing |
| Search | `qdrant_search_code`, `qdrant_index_project`, `qdrant_sync_index`, `qdrant_list_collections`, `qdrant_collection_info`, `qdrant_browse_collection`, `qdrant_reindex_file` | Semantic code search |
| Info | `ping`, `usage_instructions`, `usage_quiz`, `tool_help` | Server status and documentation |
## The Gate
Connect any Julia process and expose domain-specific tools to AI agents:
```julia
using Kaimon.Gate: GateTool, serve
function analyze_data(path::String, threshold::Float64=0.95)
data = load(path)
filter(x -> x.score > threshold, data)
end
# Kaimon auto-generates the MCP schema from the function signature
serve(tools=[GateTool(analyze_data)])
```
The connected REPL appears as a session in Kaimon's TUI. The agent can call
`analyze_data` alongside all built-in tools, with full argument validation
and type checking.
## Documentation
Full documentation: [kahliburke.github.io/Kaimon.jl](https://kahliburke.github.io/Kaimon.jl/dev/)
## Requirements
- Julia 1.12+
- Any MCP-compatible client (Claude Code, Cursor, VS Code with MCP extension)
- Optional: [Qdrant](https://qdrant.tech) for semantic code search
- Optional: [VS Code Remote Control](https://marketplace.visualstudio.com/items?itemName=nicollasricas.vscode-remote-control) extension for VS Code integration
## Contributing
Contributions are welcome. Please open an issue to discuss changes before submitting
a pull request.
## License
MIT
---
**Kaimon** (開門) — "opening the gate." The gate between AI agents and the Julia
ecosystem.