IDE Integration Guide

Connect the kinrg Model Context Protocol (MCP) server to your favorite AI Assistant to unlock semantic whole-codebase understanding.

🚀 0. Installation & Core Setup

Before configuring your IDE, you must install the kinrg CLI and build your project's Knowledge Graph.

A. Install the CLI

Install globally via UV or Pip (supports specific versions):

# Install latest version from current directory uv tool install . # Or install specific version from pip (if published) uv tool install kinrg@0.2.2 # Alternatively, using standard pip pip install kinrg==0.2.2

B. Core Actions

Navigate to your project folder and run these essential commands:

cd /path/to/your/project # 1. Build the Graph Database kinrg build # 2. Watch for file changes (Auto-updates graph when you save) kinrg watch # 3. View the graph in your browser kinrg visualize # 4. Integrate rapidly with known IDEs kinrg install

⚡ VS Code GitHub Copilot

  1. At the root of your project, create a .vscode folder if it doesn't exist.
  2. Inside `.vscode`, create a file named mcp.json.
  3. Paste the MCP configuration payload below:
{ "mcpServers": { "kinrg": { "command": "/Users/hotienky/.local/bin/kinrg", "args": [ "serve" ] } } }
Important: Reload VS Code via Cmd+Shift+P ➔ "Developer: Reload Window" after saving.

🎯 Cursor

  1. Open Cursor Settings (Cmd + ,).
  2. Navigate to Features > MCP Servers.
  3. Click + Add New MCP Server.
  4. Configure it natively as a Command Server:
  • Name: kinrg
  • Type: command
  • Command: /Users/hotienky/.local/bin/kinrg serve

🤖 Cline / Continue

  1. Open the Cline/Continue panel within your IDE.
  2. Click the </> (MCP Servers) icon to open global settings.
  3. Manually map the configuration into cline_mcp_settings.json or ~/.continue/config.json:
{ "mcpServers": { "kinrg": { "command": "/Users/hotienky/.local/bin/kinrg", "args": ["serve"] } } }

🌊 Windsurf

  1. Open your global configuration file located at ~/.codeium/windsurf/mcp_config.json.
  2. Append the Kinrg server configuration format:
{ "mcpServers": { "kinrg": { "command": "/Users/hotienky/.local/bin/kinrg", "args": ["serve"] } } }
  1. Verify your change, save the file, and restart Windsurf.

🧠 Claude Desktop

  1. Open the Claude Desktop macOS App.
  2. Click the top left Claude Menu ➔ Settings...
  3. Navigate to Developer and click Edit Config.
  4. Append the server configuration parameters:
{ "mcpServers": { "kinrg": { "command": "/Users/hotienky/.local/bin/kinrg", "args": ["serve"] } } }
  1. Completely Quit (Cmd+Q) and restart. Click the 🔨 hammer icon to verify available tools!
⚠️
Troubleshooting: "Executable file not found"
If your IDE reports a failure matching uvx: file not found in $PATH, it means your graphic application wasn't launched with your native bash/zsh shell PATH environment.

Solution: The JSON examples above deliberately use the absolute root path /Users/hotienky/.local/bin/kinrg to ensure bullet-proof execution across all IDEs. Refrain from just typing `uvx`.