home / mcp / tscircuit mcp server

tscircuit MCP Server

An MCP for tscircuit.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "charlielockyer-rice-tscircuit-mcp": {
      "command": "bun",
      "args": [
        "/path/to/tscircuit-mcp/build/index.js"
      ],
      "env": {
        "DEBUG": "DEBUG=tscircuit-mcp"
      }
    }
  }
}

You run an MCP server that connects Claude to the tscircuit electronics component registry, enabling search, browse, and analysis of components and circuit packages. It provides fast access to package details, source code, and electrical specifications, helping you build and verify circuits more efficiently.

How to use

You interact with the tscircuit MCP Server through your MCP client. Start the local server, then point Claude to the server so it can perform searches, fetch package details, retrieve source code, and analyze components. The server is designed for fast responses, clear error messages, and easy integration with Claude desktop workflows.

How to install

Prerequisites: Bun 1.0.0 or higher, or Node.js 18.0.0 or higher with npm.

1. Clone or download the tscircuit MCP repository.

2. Install dependencies.

bun install

3. Build the project.

bun run build

4. Start the server.

bun start

Development and testing

For development with hot reload, run the development script. For type checking, run the typecheck script.

bun run dev
```
```bash
bun run typecheck

Available tools

search_components

Search for electronic components in the tscircuit registry.

get_package_details

Get detailed information about a specific package.

get_package_code

Retrieve the source code for a component.

analyze_component

Analyze a component's electrical specifications and footprint.