Circuitry MCP Server

@电路/mcp服务器

MCP（模型上下文协议）服务器，允许AI编码代理访问 电路 -可视化工作流程和图表平台。

它做什么

• 可视化代码：使用双向同步从项目文件创建代码节点
• 理解图表：AI代理可以理解用户绘制的流程图和图表
• 创建流程图：通过Circuitry的聊天代理生成可视化流程图
• 数据可视化：从代码分析创建电子表格和图表

先决条件

1. 电路服务器 -下载自 电路.dev/下载
2. Node.js 18+
3. 兼容MCP的AI客户端 （克劳德代码、游标、VS代码、Gemini CLI等）

设置

1.安装和配置电路服务器

1. 下载 电路服务器 从 电路.dev/下载
2. 启动应用程序（出现在系统托盘中）
3. 单击托盘图标→ 服务器→ 偏好
4. 点击 “生成新的访问密钥”
5. 复制密钥——下一步你需要它

2.运行MCP安装程序（必需）

npx @circuitry/mcp-server setup

这将提示您输入：

• EServer地址 --按Enter键作为默认值(http://localhost:3030)
• 访问密钥 --粘贴上面生成的密钥

这会将您的凭据存储在 ~/.circuitry/mcp-config.json.

3.添加到您的AI客户端

克劳德代码

claude mcp add circuitry npx @circuitry/mcp-server

或手动添加到 ~/.claude/config.json:

{
  "mcpServers": {
    "circuitry": {
      "command": "npx",
      "args": ["-y", "@circuitry/mcp-server"]
    }
  }
}

光标

设置→ MCP → 添加新的MCP服务器：

{
  "mcpServers": {
    "circuitry": {
      "command": "npx",
      "args": ["-y", "@circuitry/mcp-server"]
    }
  }
}

VS代码/副本

code --add-mcp '{"name":"circuitry","command":"npx","args":["-y","@circuitry/mcp-server"]}'

Gemini CLI

gemini mcp add circuitry npx @circuitry/mcp-server

Cline/Windsurf

使用上述标准格式添加到MCP配置中。

4.重新启动客户端

重新启动AI客户端以加载MCP服务器。

用法示例

可视化代码文件

You: Show me the auth files as code nodes in Circuitry

Agent: I'll create code nodes from your auth files...
Done! Created 4 code nodes:
- auth/login.ts
- auth/logout.ts
- auth/middleware.ts
- auth/types.ts

Changes sync bidirectionally with your source files.

了解用户绘制的流程

You: I've drawn a flow of how I think the auth should work

Agent: I'll analyze your flow in Circuitry...

I can see you've drawn a 5-node authentication flow:
1. Start → Login Form
2. Login Form → Validate Credentials
3. Validate Credentials → branches to Success/Failure
...

创建流程图

You: Create a flowchart showing the error handling flow

Agent: I'll ask Circuitry's agent to create this flowchart...

Done! Created a flowchart with 7 nodes showing:
- Error detection
- Classification (runtime vs validation)
- Logging paths
- User notification
- Recovery options

可用工具

连接

工作流理解

节点操作

代码节点

图纸节点

代理委托

配置

配置文件

地点： ~/.circuitry/mcp-config.json

{
  "eserverUrl": "http://localhost:3030",
  "accessKey": "your-key-here",
  "configured": true
}

环境变量

命令

# Run setup wizard
npx @circuitry/mcp-server setup

# Check current configuration
npx @circuitry/mcp-server status

故障排除

“无法连接到EServer”

1. 检查EServer是否正在运行：在系统托盘中查找电路图标
2. 启动电路服务器：从下载 电路.dev/下载
3. 验证URL：运行 npx @circuitry/mcp-server status

“无效的访问密钥”

1. 创建新密钥：电路服务器→ 偏好→ 生成新的访问密钥
2. 重新运行安装程序: npx @circuitry/mcp-server setup

“未连接电路浏览器客户端”

1. 开放式电路：确保Circuity应用程序已打开
2. 刷新：尝试刷新电路页面

发展

# Clone and install
git clone https://github.com/circuitry-dev/circuitry-mcp-server.git
cd circuitry-mcp-server
npm install

# Build
npm run build

# Test locally
npx tsx src/index.ts setup
npx tsx src/index.ts status

要测试本地更改，请将MCP配置指向构建的输出：

{
  "mcpServers": {
    "circuitry": {
      "command": "node",
      "args": ["/path/to/circuitry-mcp-server/dist/index.js"]
    }
  }
}

许可证

麻省理工学院

链接

• 电路网站
• 下载电路服务器
• 报告问题