# Lineai MCP server

> Lets AI coding assistants query software dependency graphs and assess the impact of code and database changes.

- Repository: https://github.com/CodeLogicIncEngineering/codelogic-mcp-server
- Page: https://hostedmcp.org/servers/codelogicincengineering/codelogic-mcp-server
- Transport: stdio
- Stars: 37
- License: MPL-2.0
- Latest version: 1.3.0

## Install

### Claude Code

```sh
claude mcp add --env 'CODELOGIC_PASSWORD=<YOUR_CODELOGIC_PASSWORD>' --env 'CODELOGIC_SERVER_HOST=<CODELOGIC_SERVER_HOST>' --env 'CODELOGIC_USERNAME=<CODELOGIC_USERNAME>' --env 'CODELOGIC_WORKSPACE_NAME=<CODELOGIC_WORKSPACE_NAME>' codelogic-mcp-server -- uvx codelogic-mcp-server
```

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

```json
{
  "mcpServers": {
    "codelogic-mcp-server": {
      "command": "uvx",
      "args": [
        "codelogic-mcp-server"
      ],
      "env": {
        "CODELOGIC_PASSWORD": "<YOUR_CODELOGIC_PASSWORD>",
        "CODELOGIC_SERVER_HOST": "<CODELOGIC_SERVER_HOST>",
        "CODELOGIC_USERNAME": "<CODELOGIC_USERNAME>",
        "CODELOGIC_WORKSPACE_NAME": "<CODELOGIC_WORKSPACE_NAME>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "codelogic-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "codelogic-mcp-server"
      ],
      "env": {
        "CODELOGIC_PASSWORD": "<YOUR_CODELOGIC_PASSWORD>",
        "CODELOGIC_SERVER_HOST": "<CODELOGIC_SERVER_HOST>",
        "CODELOGIC_USERNAME": "<CODELOGIC_USERNAME>",
        "CODELOGIC_WORKSPACE_NAME": "<CODELOGIC_WORKSPACE_NAME>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"codelogic-mcp-server","type":"stdio","command":"uvx","args":["codelogic-mcp-server"],"env":{"CODELOGIC_PASSWORD":"<YOUR_CODELOGIC_PASSWORD>","CODELOGIC_SERVER_HOST":"<CODELOGIC_SERVER_HOST>","CODELOGIC_USERNAME":"<CODELOGIC_USERNAME>","CODELOGIC_WORKSPACE_NAME":"<CODELOGIC_WORKSPACE_NAME>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "codelogic-mcp-server": {
      "command": "uvx",
      "args": [
        "codelogic-mcp-server"
      ],
      "env": {
        "CODELOGIC_PASSWORD": "<YOUR_CODELOGIC_PASSWORD>",
        "CODELOGIC_SERVER_HOST": "<CODELOGIC_SERVER_HOST>",
        "CODELOGIC_USERNAME": "<CODELOGIC_USERNAME>",
        "CODELOGIC_WORKSPACE_NAME": "<CODELOGIC_WORKSPACE_NAME>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add codelogic-mcp-server --env 'CODELOGIC_PASSWORD=<YOUR_CODELOGIC_PASSWORD>' --env 'CODELOGIC_SERVER_HOST=<CODELOGIC_SERVER_HOST>' --env 'CODELOGIC_USERNAME=<CODELOGIC_USERNAME>' --env 'CODELOGIC_WORKSPACE_NAME=<CODELOGIC_WORKSPACE_NAME>' -- uvx codelogic-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.codelogic-mcp-server]
command = "uvx"
args = ["codelogic-mcp-server"]

[mcp_servers.codelogic-mcp-server.env]
CODELOGIC_PASSWORD = "<YOUR_CODELOGIC_PASSWORD>"
CODELOGIC_SERVER_HOST = "<CODELOGIC_SERVER_HOST>"
CODELOGIC_USERNAME = "<CODELOGIC_USERNAME>"
CODELOGIC_WORKSPACE_NAME = "<CODELOGIC_WORKSPACE_NAME>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'CODELOGIC_PASSWORD=<YOUR_CODELOGIC_PASSWORD>' -e 'CODELOGIC_SERVER_HOST=<CODELOGIC_SERVER_HOST>' -e 'CODELOGIC_USERNAME=<CODELOGIC_USERNAME>' -e 'CODELOGIC_WORKSPACE_NAME=<CODELOGIC_WORKSPACE_NAME>' codelogic-mcp-server uvx -- codelogic-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "codelogic-mcp-server": {
      "command": "uvx",
      "args": [
        "codelogic-mcp-server"
      ],
      "env": {
        "CODELOGIC_PASSWORD": "<YOUR_CODELOGIC_PASSWORD>",
        "CODELOGIC_SERVER_HOST": "<CODELOGIC_SERVER_HOST>",
        "CODELOGIC_USERNAME": "<CODELOGIC_USERNAME>",
        "CODELOGIC_WORKSPACE_NAME": "<CODELOGIC_WORKSPACE_NAME>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CODELOGIC_PASSWORD` | yes | yes | CodeLogic server password |
| `CODELOGIC_SERVER_HOST` | yes | no | url to the CodeLogic server e.g. https://myco.app.codelogic.com |
| `CODELOGIC_USERNAME` | yes | no | CodeLogic server username |
| `CODELOGIC_WORKSPACE_NAME` | yes | no | the workspace name that your code is scanned into |
| `CODELOGIC_DEBUG_MODE` | no | no | When enabled, additional debug files such as timing_log.txt and impact_data*.json will be generated. Defaults to false |
| `LINEAI_DEBUG_MODE` | no | no |  |
| `LINEAI_PASSWORD` | no | no |  |
| `LINEAI_SERVER_HOST` | no | no |  |
| `LINEAI_USERNAME` | no | no |  |
| `LINEAI_WORKSPACE_NAME` | no | no |  |

## Tools (8)

- `lineai-method-impact`
- `lineai-database-impact`
- `lineai-graph-capabilities`
- `lineai-graph-search`
- `lineai-graph-impact`
- `lineai-graph-path-explain`
- `lineai-graph-validate-change-scope`
- `lineai-graph-owners`

## FAQ

### What does the Lineai MCP server let my AI assistant do?

It lets the assistant run impact assessments on methods and database entities and explore dependency graphs via graph search, impact, path explanation and change-scope validation tools.

### How do I authenticate the Lineai MCP server?

You provide environment variables with your Lineai server host, username and password in your MCP client configuration.

### Which IDEs and clients can I configure Lineai MCP with?

The README covers VS Code with GitHub Copilot, Claude Desktop, Windsurf IDE and Cursor.

### What does the method impact tool do?

It pulls an impact assessment from Lineai's APIs for a given method, doing a bounded upstream traversal with a default depth of 3.

### What happens if the graph API is not deployed?

The server returns a clear "graph not available" style message, and you can fall back to the method and database impact tools.
