# The local server

For a project that lives on your disk, next to KiCad. The local server answers your assistant's questions about it (parts, nets, check results, routing, a picture) and writes nothing. It needs no account and your files stay where they are.

| | Local server (this page) | [Hosted server](https://crossprobe.ai/docs/mcp/) |
|---|---|---|
| Works on | A KiCad project folder on your disk | Projects stored in your Crossprobe account |
| Can | Read: answer questions, review, draw a picture | Read, build a board from requirements, change a design |
| Writes | Nothing | New revisions in your account |
| Needs | [Node.js](https://nodejs.org/) 20 or later | An account (you sign in from your assistant) |
| Cost | Free | One board build a day free; more with a plan |

To have a board built, or to have your assistant change a design, use the [hosted server](https://crossprobe.ai/docs/mcp/).

## Install

The server is the npm package [`@crossprobe/mcp`](https://www.npmjs.com/package/@crossprobe/mcp) (Apache-2.0). There is nothing to install by hand: your MCP client starts it with `npx`, which downloads it the first time and keeps it cached. You need [Node.js](https://nodejs.org/) 20 or later. To check that it runs:

```sh
npx -y @crossprobe/mcp --version
```

The server is read-only from version 0.2.0.

## Connect your assistant

The server takes one argument: the KiCad project, as its folder or its `.kicad_pro` file. Without one, it uses the folder it was started in. You can also leave it out and tell the assistant which project to open.

### Claude Code

In a terminal, in your project's folder:

```sh
claude mcp add crossprobe-local -- npx -y @crossprobe/mcp .
```

Start `claude` in that folder, and `/mcp` shows the server and its tools.

### Claude Desktop

Open *Settings › Developer › Edit Config* and add the server to `claude_desktop_config.json`. Give the project as a full path. Then restart Claude Desktop.

```json
{
  "mcpServers": {
    "crossprobe-local": {
      "command": "npx",
      "args": ["-y", "@crossprobe/mcp", "/Users/you/kicad/my-board"]
    }
  }
}
```

### Cursor and other MCP clients

The same command works everywhere. In Cursor, put the JSON above in `.cursor/mcp.json` in your workspace (or in `~/.cursor/mcp.json` for all workspaces). Other clients take a command and arguments in their MCP settings.

## What to ask

Ask about the design in your own words. The assistant looks things up with the tools before it answers. For example:

- "Which ICs have no decoupling capacitor on their supply pins?"
- "What's connected to the I²C bus, and does it have pull-ups?"
- "Triage the DRC results: which ones matter?"
- "Does every connector pin have a net, or a no-connect flag?"

For a full review, use the server's **design_review** prompt (in Claude Code: `/mcp__crossprobe-local__design_review`). The assistant says what to change and where; you make the changes in KiCad or in the [Crossprobe editor](https://crossprobe.ai/app/).

The server reads the project again whenever a file changed, so after you save in KiCad, the next answer is about the design as it is now.

## Its tools

`open_project`, `get_overview`, `list_components`, `get_component`, `list_nets`, `get_net`, `get_checks`, `check_requirements`, `check_compatibility`, `get_board_routing`, `render_design`, and `report_finding` with `list_findings` to collect review findings during a session. [Tools and edits](https://crossprobe.ai/docs/mcp/tools/) says what each one returns.

## What leaves your computer

The server itself sends nothing anywhere: it reads your project from disk and answers your MCP client. The client's model sees what the tools return when it asks, for example a part's pins, a net, or a list of check results. It never gets your files as a whole. Where that model runs is up to your client and its settings.

## If something doesn't work

- **The server doesn't start, or "npx: command not found".** MCP clients don't always see your shell's `PATH`. Use the full path to npx as the command: `which npx` (macOS and Linux) or `where npx` (Windows) prints it.
- **"No KiCad project (.kicad_pro) in …".** The folder given has no project within three levels. Give the project's folder or its `.kicad_pro`, or ask the assistant to open it.
- **Answers don't match what I see in KiCad.** The server reads saved files. Save in KiCad, then ask again.
- **The assistant says the server only reads.** It does. Store the project in your account and use the [hosted server](https://crossprobe.ai/docs/mcp/) to build or change a design.
