Content
# Yuanlitu MCP
Yuanlitu MCP is a local MCP tool for Jialichuang EDA / EasyEDA Professional Edition. It exposes the schematic capabilities within EDA through native whitelist RPC to MCP Hosts like Codex, Claude, Trae, etc., allowing AI to read, inspect, and securely modify the currently open schematic.
This repository is a public distribution repository that only provides binary release packages and usage instructions, without including the server-side source code.
## Current Version
First available test version: `v0.1.1`
Default connection parameters:
- Port range: `49640-49649`
- WebSocket path: `/yuanlitu-mcp`
- Service identifier: `yuanlitu-mcp`
## Capabilities
The current version focuses on schematics and does not provide PCB routing-related capabilities.
- Connection status check: Confirm EasyEDA extension, current project, current schematic, and current page.
- Schematic page reading: List schematics and pages within the project.
- Schematic structured reading: Read components, pins, wires, net labels, nets, and component properties.
- Local area inspection: Read components and wires within a specified rectangular area.
- Component library search: Search EasyEDA / LCSC components by model, package, and parameters.
- Component placement: Place library components into the current schematic page.
- Secure wiring: Create wires, connect pins, create power/ground nets, and create net ports.
- Attribute modification: Modify existing component attributes, such as Value, supplier information visibility, etc.
- NC marking: Add or remove non-connection identifiers for unused pins.
- Text annotation: Add design notes, pin header definitions, and layout precautions.
- Schematic DRC: Trigger EasyEDA schematic inspection.
- Readability analysis: Estimate wire crossings, zero-length lines, component congestion, etc.
- Automatic backup: Automatically backup the schematic when writing for the first time in each session to reduce the risk of misoperation.
Typical uses:
- Let AI help you check schematic issues such as floating, unconnected, duplicate reference designators, and net naming.
- Add local circuits according to design requirements, such as USB, LDO, buttons, pin headers, decoupling, etc.
- Repair explicit issues based on DRC results.
- Let AI generate or organize schematic drafts for core boards, module boards, interface boards, etc.
## Not Provided
- Automatic PCB routing.
- High-risk PCB writing capabilities such as signal line routing, vias, and copper pours.
- Cloud AI request capabilities. This tool is only responsible for MCP and EDA local connections; AI capabilities are provided by MCP Hosts like Codex, Claude, Trae, etc.
- Source code public distribution. The public repository only releases exe and EasyEDA extension packages.
## Download
Download the latest version from GitHub Releases:
[https://github.com/lyq11/yuanlitu-mcp-service-public/releases](https://github.com/lyq11/yuanlitu-mcp-service-public/releases)
Release packages usually contain:
- `yuanlitu-mcp-private-v0.1.1-win-x64.zip`: Complete Windows distribution package.
- `yuanlitu-mcp.exe`: MCP server single-file executable program.
- `yuanlitu-mcp-service_v0.1.1.eext`: Jialichuang EDA / EasyEDA Professional Edition extension.
## Installation Steps
1. Download the `.zip` package or separately download `.exe` and `.eext` from the release.
2. Unzip to a fixed directory, such as:
```text
C:\Tools\yuanlitu-mcp\
```
3. Install the `.eext` extension in Jialichuang EDA / EasyEDA Professional Edition.
4. Open the EDA project and schematic page.
5. Configure `yuanlitu-mcp.exe` in the MCP Host.
6. Restart the MCP Host or refresh the MCP connection in the Host.
7. Check the connection status in the EDA plugin menu; click "Reconnect" if necessary.
## Codex Configuration
Add to:
```text
C:\Users\<your_username>\.codex\config.toml
```
Example:
```toml
[mcp_servers.yuanlitu_easyeda]
command = "C:/Tools/yuanlitu-mcp/yuanlitu-mcp.exe"
args = []
startup_timeout_sec = 20
tool_timeout_sec = 120
```
If you want Codex to ask less about read-only tools, you can add:
```toml
[mcp_servers.yuanlitu_easyeda.tools.easyeda_health]
approval_mode = "approve"
[mcp_servers.yuanlitu_easyeda.tools.schematic_list_pages]
approval_mode = "approve"
[mcp_servers.yuanlitu_easyeda.tools.schematic_inspect_page]
approval_mode = "approve"
```
## Claude Desktop Configuration
Open the Claude Desktop configuration file and add:
```json
{
"mcpServers": {
"yuanlitu_easyeda": {
"command": "C:/Tools/yuanlitu-mcp/yuanlitu-mcp.exe",
"args": []
}
}
}
```
Restart Claude Desktop after modification.
## Trae Configuration
Add to Trae's MCP configuration:
```json
{
"mcpServers": {
"yuanlitu_easyeda": {
"command": "C:/Tools/yuanlitu-mcp/yuanlitu-mcp.exe",
"args": []
}
}
}
```
Restart Trae or refresh the MCP service after modification.
## Usage Suggestions
- Let AI execute connection checks before reading the current schematic page.
- For write operations, suggest AI explain the area and components to be modified.
- Before large-scale modifications, confirm the current schematic is `[main]`, and backup pages should be marked as `[backup]`.
- If the EDA plugin shows waiting for connection, check if the MCP Host has started `yuanlitu-mcp.exe` and if port `49640-49649` is occupied.
## FAQs
### Is it necessary to open the source code?
No. The current public repository only releases binary packages without source code. Note that this is not an encryption or absolute anti-reverse solution, but rather a source-code-free executable package for ordinary user distribution scenarios.
### Why doesn't the plugin itself include the AI API Key?
The basic version is positioned as a pure MCP tool, and AI requests are responsible for MCP Hosts. This way, users can directly use existing tools like Codex, Claude, Trae, etc., without needing to configure API Keys in the EDA plugin.
### What if Windows prompts an unknown publisher?
The current exe is not code-signed, and Windows may prompt an unknown publisher. It is recommended to add code signing for formal commercial releases.
## Version Records
### v0.1.1
- Fix extension status hover window Chinese garbled characters.
- Fix waiting status port range display error, uniformly display `49640-49649`.
- Split into schematic MCP tools, remove PCB routing-related capabilities.
- Release public distribution repository, keep source code repository private.
