rftools-mcp

关键词

RF计算器电子工程仿真工具S参数分析云端计算

使用说明内容（Markdown格式）

项目简介

  • 这是一个 MCP 服务器实现，负责向 MCP 客户端暴露 rftools.io 的大量电子设计与 RF 工具（计算器）以及服务器端仿真工具的访问能力。服务器通过 MCP 的工具注册机制，处理来自 LLM 客户端的请求（如列出计算器、获取计算器信息、运行计算、列出仿真工具、提交并获取仿真结果），并通过标准的 JSON-RPC 交互实现通信。

主要功能点

  • Calculator tools（计算器相关）
    • list_calculators：列出可用计算器，支持按类别过滤。
    • get_calculator_info：获取指定计算器的详细信息（输入、输出、公式等）。
    • run_calculation：使用给定输入参数运行指定计算器，返回结果和可互动链接。
  • Simulation tools（服务器端仿真工具）
    • list_simulation_tools：列出所有可用的仿真工具及其参数参考。
    • run_simulation：提交仿真作业，轮询获取结果，返回完整结果数据与结果链接。
  • 传输与协作
    • 通过 MCP 的 Stdio/server transport 进行本地化通信，兼容 AI 助手的对话式调用。
    • 支持 API key 保护的仿真工具调用（RFTOOLS_API_KEY，API_BASE 为可选的自定义 API 地址）。
  • 会话与能力声明
    • 服务器声明自身名称、版本等信息，并注册多个工具，确保 LLM 客户端能够通过统一接口访问计算能力与仿真能力。

安装步骤

  1. 安装 Node.js 环境（推荐使用 Node.js 16+，具体版本以项目依赖为准）。
  2. 将仓库，通过 npm/yarn 安装依赖并准备运行入口（该 MCP 服务器通过 npx rftools-mcp 启动，或本地编译后直接启动入口）。
  3. 启动服务器（示例用法与客户端配置在下方给出，亦可通过 npx 直接运行）：
    • 直接在命令行执行：npx -y rftools-mcp 以便下载安装并启动 MCP 服务器。
    • 启动时如需访问仿真工具，请设置 RFTOOLS_API_KEY 环境变量（用于提交并轮询服务器端仿真作业）。
  4. 如要在客户端进行集成，请提供正确的 MCP 服务器连接信息并确保 API-Key（若使用仿真工具）已配置。

服务器配置（给 MCP 客户端使用的示例配置说明）

以下为 MCP 客户端的配置示例（以 JSON 形式呈现，供客户端配置参考，实际请按客户端文档填写，不在代码块中呈现）： { "serverName": "rftools", "command": "npx", "args": ["-y", "rftools-mcp"], "env": { "RFTOOLS_API_KEY": "rfc_your_key_here", "RFTOOLS_API_BASE": "https://rftools.io/api/py" // 如需自定义后端 API 地址可配置，默认值来自仓库设定 } } 说明与注释：

  • serverName：MCP 服务器的标识名称，本文档对应的实现中使用的名称为 rftools。
  • command/args：MCP 客户端启动该 MCP 服务器的命令和参数。README 中的实际用法是通过 npx -y rftools-mcp 启动。
  • env：如有需要提供 API Key（如仿真工具需要），请将 RFTOOLS_API_KEY 设置为有效的密钥，否则仅使用 Calculator（计算器）工具，不需要 API Key。
  • RFTOOLS_API_BASE：若要自定义后端 API 地址，可设置该环境变量；未设置时使用仓库内默认值。

基本使用方法

  • 通过 Claude Desktop/Cursor 等集成
    • 在客户端的 MCP 服务器配置中，填入以上启动命令与参数，确保 API Key（若使用仿真工具）已配置。
    • 启动后，AI 助手即可通过 MCP 请求以下工具：list_calculators、get_calculator_info、run_calculation、list_simulation_tools、run_simulation。
  • 使用流程示例
    • 查询可用计算器：AI 调用 list_calculators，返回可用计算器列表及分类信息。
    • 获取计算器细节：AI 调用 get_calculator_info，传入 slug，获得输入、输出、公式、示例等。
    • 运行计算：AI 调用 run_calculation，传入 slug 与 inputs，获得结果及交互链接。
    • 查询仿真工具：AI 调用 list_simulation_tools，获取可用工具和参数参考。
    • 提交仿真任务并获取结果：AI 调用 run_simulation，传入 jobType 与参数，服务器将提交作业并轮询直到完成或超时，返回结果数据与结果页面链接。

说明：如果仅使用计算器功能，无需 RFTOOLS_API_KEY；若要启用仿真工具，请确保 RFTOOLS_API_KEY 已正确配置且具备相应额度。

服务器信息

访问项目