内容
电子 MCP 服务器
<!-- mcp-name: io.github.wedsamuel1230/electronic-mcp-server -->
一款全面的模型上下文协议（MCP）服务器，提供 3 个领域中 14 种电子工程工具。
[](https://pypi.org/project/electronics-mcp-servers/)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
## 安装
```bash
pip install electronics-mcp-servers
```
## 测试与验证
安装后，验证软件包是否正常工作：
### 使用 uvx 进行测试（推荐用于 MCP 客户端）
```bash
# 替代：测试单个服务器
uvx --from electronics-mcp-servers resistor-decoder
uvx --from electronics-mcp-servers capacitor-calc
uvx --from electronics-mcp-servers gpio-reference
```
### 使用 pip 安装进行测试
```bash
# 安装后，测试 CLI
electronics-mcp-servers --# 或测试单个工具
resistor-decoder --helpitor-calc --help
gpiohelp
```
### 命名说明
该项目在不同上下文中使用不同的命名约定：
- **MCP 注册表 ID：** `io.github.wedsamuel1230/electronic-mcp-server` （单数）
- **PyPI 软件包：** `electronics-mcp-servers` （复数）
- **CLI 可执行文件：** `electronics-mcp-servers`、`resistor-decoder`、`capacitor-calc`、`gpio-reference`
使用 `uvx` 时，始终使用 **PyPI 软件包名称** (`electronics-mcp-servers`)。
### 故障排除
**问题：** `uvx electronics-mcp-servers` 显示“executable not provided”错误
**解决方案：** 主要的 `electronics-mcp-servers` 可执行文件已在 **1.0.2** 版本中添加。确保您拥有最新版本：
```bash
# 强制 uvx 获取最新版本
uvx --refresh electronics-mcp-servers
# 或显式指定版本
uvx --from electronics-mcp-servers==1.0.2 electronics-mcp-servers
# 检查已安装的版本
pip index versions electronics-mcp-servers
```
如果错误仍然存在，PyPI 可能仍在提供 1.0.1 版本。请等待几分钟，然后再试一次。
## 功能
### 🎨 电阻解码器（3 种工具）
- **decode_resistor_color_bands**：将颜色带转换为电阻值
- **encode_resistor_value**：将电阻转换为颜色带
- **find_standard_resistor**：查找最近的 E12/E24/E96 系列值
### ⚡ 电容器计算器（4 种工具）
- **calculate_capacitive_reactance**：频率相关的阻抗
- **calculate_rc_time_constant**：RC 电路时间计算
- **calculate_resonant_frequency**：LC 谐振
- **suggest_capacitor_for_filter**：滤波器设计建议
### 📌 GPIO 引脚参考（7 种工具）
- **get_pin_info**：详细的引脚规格（ESP32/Arduino/STM32）
- **find_pwm_pins**：PWM 能力引脚发现
- **find_adc_pins**：ADC 通道映射
- **find_i2c_pins**：I2C 总线引脚
- **find_spi_pins**：SPI 总线引脚
- **check_pin_conflict**：多引脚冲突检测
- **generate_pin_diagram_ascii**：视觉引脚图
## 支持的板卡
- **ESP32 DevKitC**
- **Arduino UNO R3**
- **STM32F103C8T6** （蓝色药丸）
## 用法
### 作为 MCP 服务器
添加到您的 MCP 客户端配置（例如，Claude Desktop）：
```json
{
"mcpServers": {
"electronics": {
"command": "python",
"args": ["-m", "servers"]
}
}
}
```
或使用 uvx：
```json
{
"mcpServers": {
"electronics": {
"command": "uvx",
"args": ["electronics-mcp-servers"]
}
}
}
```
### 直接 Python 使用
```python
from servers.resistor_decoder import decode_color_bands
from servers.capacitor_calculator import calculate_rc_time_constant
from servers.gpio_reference import get_pin_info
# 解码电阻器
result = decode_color_bands(["brown", "black", "red", "gold"])
# 返回：{"resistance": 1000, "tolerance": 5, "formatted": "1kΩ ±5%"}
# 计算 RC 时间常数
tau = calculate_rc_time_constant(10000, 100e-6)
# 返回：{"tau": 1.0, "time_63pct": 1.0, "time_full": 5.0}
# 获取 ESP32 引脚信息
pin = get_pin_info("ESP32", 32)
# 返回详细的引脚能力
```
## 要求
- Python 3.10+
- FastMCP (`mcp[cli]>=1.1.0`)
## 许可证
MIT 许可证 - 版权所有 (c) 2026 Samuel F.
## 链接
- [GitHub 仓库](https://github.com/wedsamuel1230/electronic-mcp-server)
- [PyPI 软件包](https://pypi.org/project/electronics-mcp-servers/)
- [MCP 注册表](https://registry.modelcontextprotocol.io/servers/io.github.wedsamuel1230/electronic-mcp-server)
