Sheetsdata Mcp

SheetsData MCP

面向 AI Agent 的电子元器件数据手册 — 提供制造商 PDF 中的引脚排列、规格、封装信息和设计检查。

SheetsData 是托管式 MCP 服务。你的 Agent 可以在 JLCPCB、Mouser 和 DigiKey 上查找元器件，以文本和表格形式读取元器件数据手册的任意章节、比较元器件、检查 BOM，并根据数据手册的额定值核查工作条件。Agent 无需查看 PDF，你也不必查找或粘贴 PDF。

Server URL:  https://mcp.sheetsdata.com/mcp   (Streamable HTTP)
Sign-in:     MCP OAuth (browser), or an API key as "Authorization: Bearer <key>"

此仓库包含安装配置、供只能启动本地服务的客户端使用的 @sheetsdata/mcp stdio 代理，以及 Claude Desktop 安装包。服务本身是托管式服务。

创建免费账户  ·  在客户端中安装  ·  定价  ·  文档

效果展示

“TPS54302 能否在 24 V 输入、2.5 A 输出的条件下正常工作？”

check_design_fit("TPS54302", input_voltage=24, output_current=2.5)

overall: WARNING
  input_voltage  24 V  PASS  within the recommended range 4.5–28 V (14.3% margin)
                             datasheet row: "| V I |  | 4.5 | 28 | V |"
  unmatched: output_current

如果工具找不到某项条件的限制值，该条件会标记为 unmatched，并使判定结果保持为 WARNING：只有所有条件都经过数据手册核查，结果才会是 PASS。

“输入 24 V、输出至少 2 A 的降压转换器”（免费）：

find_parts("buck converter", constraints=[vin_max >= 24 V, iout >= 2 A])

AP63357DV-7       32 V  3.5 A  pass@digikey   stock: DigiKey 49,457   datasheet: ready
LM2596S-5.0/NOPB  40 V  3 A    pass@digikey   stock: DigiKey 4,460    datasheet: ready
LMR33630ADDAR     36 V  3 A    pass@digikey   stock: JLCPCB 17,768    datasheet: ready

read_datasheet("TPS54302", section="pinout")
→ GND (1), SW (2), VIN (3), FB (4), EN (5), BOOT (6)

工具

每次调用的价格在所有套餐中均相同。失败的调用不收费。当前价格请查看 sheetsdata.com/pricing。

请提供制造商料号（TPS54302、STM32F446RCT6）或 LCSC 编号（C2837938），不要提供 100nF 这类数值或 R1 这类位号。尚无人请求的数据手册会在首次请求时读取（轮询 check_extraction_status）；之后会缓存，供所有人使用。

提示词

内置提示词可引导 Agent 完成常见硬件任务：

资源

定价

• 免费开始。 新账户可获得 $5 额度，无需信用卡（添加信用卡后再获 $20）。搜索（search_parts、find_parts）免费。
• 试用版采用预付余额按量付费：每天可查询 5 份新数据手册（已读取的数据手册不限量），每分钟 30 次请求。
• 专业版最低每月 $39，调用费用计入月费：每天查询新数据手册不限量，速率限制更高，并可使用私有元件库。

套餐、限制和费用：sheetsdata.com/pricing。

身份验证

选择客户端支持的方式即可；两种方式均计入同一组织的账单。

如果客户端询问如何注册 OAuth 客户端，请选择自动（动态）注册；SheetsData 目前尚不支持客户端 ID 元数据文档。

安装

一键安装（首次使用时登录）：

以下每个客户端均已于 2026-10-16 根据其各自的文档进行核验（链接见各节）。在代码片段中，将 YOUR_API_KEY 替换为从 sheetsdata.com/dashboard/keys 获取的密钥。

• Claude（claude.ai 和 Claude Desktop）
• Claude Code
• ChatGPT
• OpenAI Codex
• Cursor
• VS Code（GitHub Copilot）
• GitHub Copilot CLI
• Gemini CLI
• Google Antigravity
• Windsurf（Devin Desktop）
• Zed
• Cline
• Roo Code
• Continue
• Goose
• Amp
• Kiro
• JetBrains（Junie 和 AI Assistant）
• opencode
• LM Studio
• Warp
• 仅启动本地服务的客户端
• 自有代码

Claude（claude.ai 和 Claude Desktop）

自定义连接器（OAuth）。 打开 Customize → Connectors，点击 + Add，然后选择 Add custom connector。将其命名为 SheetsData，粘贴 https://mcp.sheetsdata.com/mcp，然后点击 Continue。在 OAuth client 下，选择 Register automatically：SheetsData 暂不支持默认的“Use Claude's published identity”选项。点击 Add，然后点击 Connect，并在打开的浏览器标签页中登录 SheetsData。Team 和 Enterprise 套餐的用户需由所有者通过 Organization settings → Connectors → Add → Custom → Web 添加。免费套餐可添加一个自定义连接器。

Claude Desktop 安装包。 从最新发布版本下载 sheetsdata-x.y.z.mcpb，并将其拖到 Claude Desktop 窗口中。若要使用 OAuth 登录，请将 API 密钥字段留空；也可以粘贴密钥。

{
  "mcpServers": {
    "sheetsdata": {
      "command": "npx",
      "args": ["-y", "@sheetsdata/mcp"],
      "env": { "SHEETSDATA_API_KEY": "YOUR_API_KEY" }
    }
  }
}

文档：使用远程 MCP 的自定义连接器

Claude Code

claude mcp add --transport http sheetsdata https://mcp.sheetsdata.com/mcp

启动 Claude Code，运行 /mcp，选择 sheetsdata → Authenticate 并登录（或在 shell 中运行 claude mcp login sheetsdata）。添加 --scope user，即可在每个项目中使用 SheetsData。

claude mcp add --transport http sheetsdata https://mcp.sheetsdata.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

文档：Claude Code MCP

ChatGPT

在网页上打开 chatgpt.com/plugins，点击 +，然后点击 Add custom MCP server。将其命名为 SheetsData，粘贴 https://mcp.sheetsdata.com/mcp 并选择 OAuth。接受警告，选择 Create as a plugin，安装并登录 SheetsData。是否可以使用自定义服务取决于你的套餐和工作区设置。ChatGPT 无法发送 API 密钥。

文档：ChatGPT 中的自定义 MCP 服务

OpenAI Codex

codex mcp add sheetsdata --url https://mcp.sheetsdata.com/mcp
codex mcp login sheetsdata

第二条命令会打开浏览器供你登录。Codex IDE 扩展和应用读取同一个 ~/.codex/config.toml。

[mcp_servers.sheetsdata]
url = "https://mcp.sheetsdata.com/mcp"
bearer_token_env_var = "SHEETSDATA_API_KEY"

文档：Codex MCP

Cursor

点击 在 Cursor 中安装，或添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "sheetsdata": {
      "url": "https://mcp.sheetsdata.com/mcp"
    }
  }
}

Cursor 首次连接时会打开浏览器供你登录。

{
  "mcpServers": {
    "sheetsdata": {
      "url": "https://mcp.sheetsdata.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

文档：Cursor MCP

VS Code（GitHub Copilot）

点击 在 VS Code 中安装，运行 code --add-mcp '{"name":"sheetsdata","type":"http","url":"https://mcp.sheetsdata.com/mcp"}'，或添加到 .vscode/mcp.json（若要应用于所有工作区，请运行 MCP: Open User Configuration）：

{
  "servers": {
    "sheetsdata": {
      "type": "http",
      "url": "https://mcp.sheetsdata.com/mcp"
    }
  }
}

启动服务后，VS Code 会提示你登录。请在 Agent 模式下通过 Copilot Chat 使用它。

{
  "inputs": [
    { "type": "promptString", "id": "sheetsdata-key", "description": "SheetsData API key", "password": true }
  ],
  "servers": {
    "sheetsdata": {
      "type": "http",
      "url": "https://mcp.sheetsdata.com/mcp",
      "headers": { "Authorization": "Bearer ${input:sheetsdata-key}" }
    }
  }
}

文档：VS Code MCP 配置

GitHub Copilot CLI

copilot mcp add --transport http sheetsdata https://mcp.sheetsdata.com/mcp

或者在会话中运行 /mcp add，选择 HTTP 并粘贴 URL。服务发出请求时，Copilot CLI 会通过 OAuth 登录。

copilot mcp add --transport http sheetsdata https://mcp.sheetsdata.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

文档：向 Copilot CLI 添加 MCP 服务

Gemini CLI

gemini mcp add --transport http --scope user sheetsdata https://mcp.sheetsdata.com/mcp

启动 Gemini CLI，运行 /mcp auth sheetsdata 并登录。

gemini mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  sheetsdata https://mcp.sheetsdata.com/mcp

文档：Gemini CLI MCP 服务

Google Antigravity

打开 … 菜单 → MCP Servers → Manage MCP Servers → View raw config（~/.gemini/config/mcp_config.json，或工作区中的 .agents/mcp_config.json），并添加：

{
  "mcpServers": {
    "sheetsdata": {
      "serverUrl": "https://mcp.sheetsdata.com/mcp"
    }
  }
}

Antigravity 需要 serverUrl；使用 url 会被拒绝。然后打开 Agent settings → Customizations，点击 sheetsdata 旁边的 Authenticate。如需使用 API 密钥，请在条目中添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

文档：Antigravity MCP

Windsurf（Devin Desktop）

在 Cascade 面板中，打开 … 菜单 → MCPs → Open MCP config file（~/.config/devin/mcp_config.json；Windows 上为 %APPDATA%\devin\mcp_config.json；较早版本的 Windsurf 使用 ~/.codeium/windsurf/mcp_config.json），然后添加：

{
  "mcpServers": {
    "sheetsdata": {
      "serverUrl": "https://mcp.sheetsdata.com/mcp"
    }
  }
}

连接时，你需要在浏览器中登录 SheetsData。若要使用 API 密钥，请在条目中添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

文档：Cascade MCP

Zed

将以下内容添加到 Zed 的 settings.json 中（或依次选择 Settings → AI → MCP Servers → Add Server → Add Remote Server）：

{
  "context_servers": {
    "sheetsdata": {
      "url": "https://mcp.sheetsdata.com/mcp"
    }
  }
}

Zed 会提示你登录。若要使用 API 密钥，请在条目中添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

文档：Zed MCP

Cline

打开 MCP Servers → Remote Servers，将名称设为 SheetsData，粘贴 https://mcp.sheetsdata.com/mcp，选择 Streamable HTTP，然后点击 Add Server；出现提示时，在浏览器中完成登录。在 Cline CLI 中，运行 cline mcp 并为 sheetsdata 选择 Authorize OAuth。

{
  "mcpServers": {
    "sheetsdata": {
      "type": "streamableHttp",
      "url": "https://mcp.sheetsdata.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

文档：Cline MCP

Roo Code

Roo Code 的文档未介绍 MCP OAuth，因此请使用 API 密钥。打开 MCP → Edit Global MCP（mcp_settings.json）或项目中的 .roo/mcp.json：

{
  "mcpServers": {
    "sheetsdata": {
      "type": "streamable-http",
      "url": "https://mcp.sheetsdata.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

文档：在 Roo Code 中使用 MCP

Continue

Continue 的文档未介绍 MCP OAuth，因此请使用 API 密钥。将文件保存为工作区中的 .continue/mcpServers/sheetsdata.yaml，并将 SHEETSDATA_API_KEY 添加到 Continue 密钥中：

name: SheetsData
version: 0.0.1
schema: v1
mcpServers:
  - name: SheetsData
    type: streamable-http
    url: https://mcp.sheetsdata.com/mcp
    requestOptions:
      headers:
        Authorization: "Bearer ${{ secrets.SHEETSDATA_API_KEY }}"

文档：Continue MCP

Goose

在 Goose Desktop 中，打开 Extensions → Add custom extension，选择 Streamable HTTP，并填入 URL https://mcp.sheetsdata.com/mcp；在 CLI 中，运行 goose configure → Add Extension → Remote Extension (Streamable HTTP)。连接时，Goose 会启动 OAuth 登录流程。或者，将以下内容添加到 ~/.config/goose/config.yaml：

extensions:
  sheetsdata:
    name: SheetsData
    type: streamable_http
    uri: https://mcp.sheetsdata.com/mcp
    enabled: true
    timeout: 300

若要使用 API 密钥，请在条目中添加 headers: { Authorization: "Bearer YOUR_API_KEY" }。

文档：在 Goose 中使用扩展

Amp

amp mcp add sheetsdata https://mcp.sheetsdata.com/mcp

Amp 会在浏览器中打开登录页面。

{
  "amp.mcpServers": {
    "sheetsdata": {
      "url": "https://mcp.sheetsdata.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

文档：Amp MCP

Kiro

点击在 Kiro 中安装，或将以下内容添加到 ~/.kiro/settings/mcp.json（或工作区中的 .kiro/settings/mcp.json）：

{
  "mcpServers": {
    "sheetsdata": {
      "url": "https://mcp.sheetsdata.com/mcp"
    }
  }
}

Kiro 会提示你登录。若要使用 API 密钥，请在条目中添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

文档：Kiro MCP 配置

JetBrains（Junie 和 AI Assistant）

Junie（IDE 和 CLI）：添加到 ~/.junie/mcp/mcp.json（或项目中的 .junie/mcp/mcp.json），然后运行 /mcp 并选择 Authorize。如需使用 API 密钥，请添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

{
  "mcpServers": {
    "sheetsdata": {
      "url": "https://mcp.sheetsdata.com/mcp"
    }
  }
}

AI Assistant：其文档未说明远程服务的 OAuth 或请求头，因此请运行本地代理。打开 Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add，然后粘贴下方的 stdio 配置项。

文档：Junie MCP、AI Assistant MCP

opencode

添加到 opencode.json：

{
  "mcp": {
    "sheetsdata": {
      "type": "remote",
      "url": "https://mcp.sheetsdata.com/mcp",
      "enabled": true
    }
  }
}

opencode 会自动登录，也可以运行 opencode mcp auth sheetsdata。如需使用 API 密钥，请在配置项中添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

文档：opencode MCP servers

LM Studio

LM Studio 的文档未说明 MCP OAuth，因此请使用 API 密钥。打开 Program 标签页 → Install → Edit mcp.json：

{
  "mcpServers": {
    "sheetsdata": {
      "url": "https://mcp.sheetsdata.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

文档：LM Studio MCP

Warp

打开 Settings → Agents → MCP servers → + Add，然后粘贴：

{
  "sheetsdata": {
    "url": "https://mcp.sheetsdata.com/mcp"
  }
}

服务启动时，Warp 会打开浏览器供你登录。如需使用 API 密钥，请在配置项中添加 "headers": { "Authorization": "Bearer YOUR_API_KEY" }。

文档：Warp MCP

仅启动本地服务的客户端

@sheetsdata/mcp 软件包（Node.js 20.18.1 或更高版本）可将 stdio 代理到托管服务。未设置 SHEETSDATA_API_KEY 时，它会打开浏览器，通过 OAuth 登录并缓存令牌。

{
  "mcpServers": {
    "sheetsdata": {
      "command": "npx",
      "args": ["-y", "@sheetsdata/mcp"],
      "env": { "SHEETSDATA_API_KEY": "YOUR_API_KEY" }
    }
  }
}

在 shell 中运行：SHEETSDATA_API_KEY=YOUR_API_KEY npx -y @sheetsdata/mcp，或运行 npx -y @sheetsdata/mcp --api-key YOUR_API_KEY。

你自己的代码

通过 Streamable HTTP 使用 MCP TypeScript SDK 连接（SDK 也可以运行 OAuth 流程）：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(new URL("https://mcp.sheetsdata.com/mcp"), {
  requestInit: { headers: { Authorization: "Bearer YOUR_API_KEY" } },
});
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const result = await client.callTool({ name: "search_parts", arguments: { query: "TPS54302" } });

推荐工作流

1. search_parts / find_parts → candidates by part number, keyword or spec
2. get_part_details          → parameters, package, pricing, stock
3. read_datasheet            → "summary" first, then the sections you need
4. check_design_fit          → your operating conditions against the ratings
5. find_alternative          → substitutes, if needed
6. compare_parts             → finalists side by side
7. check_bom                 → lifecycle, stock and sourcing for the whole BOM

支持

• 电子邮件：[email protected]
• 问题：github.com/octoco-ltd/sheetsdata-mcp/issues
• 文档：sheetsdata.com/help

免责声明

数据由自动化工具（包括 AI）从公开的制造商数据手册中提取，可能包含错误、遗漏或不准确之处。

SheetsData 和 Octoco Ltd 按“原样”提供这些数据，不对其准确性、完整性或是否适用于任何特定用途作出任何明示或默示的保证。 在作出设计、采购或制造决策前，请务必根据制造商的官方数据手册核实关键规格。

使用本服务即表示你确认：

• 提取的数据可能与制造商原始数据手册有所不同
• SheetsData 不能替代对官方文档的查阅
• 对于因使用这些数据而导致的任何损害、损失或设计故障，Octoco Ltd 概不负责
• 功能、API 和定价可能发生变化

使用条款请参阅 sheetsdata.com/terms。

许可证

MIT（本仓库：安装配置、npm 代理和 Claude Desktop 捆绑包）。托管服务受使用条款约束。