mcpField
🔐
🔐 get-mcp-keys

🔐 get-mcp-keys

本地服务
github.com/StuMason开发工具1284 周前更新

关于 🔐 get-mcp-keys

get-mcp-keys 面向使用 Cursor 等 AI 编码工具的开发者,从 `~/.mcprc` 读取密钥并注入环境变量,再运行 MCP 服务命令,避免在仓库中保存凭据。

主要功能

  1. 01从 `~/.mcprc` 加载密钥
  2. 02将密钥注入环境变量
  3. 03运行配置的 MCP 服务命令
  4. 04调试输出隐藏密钥大部分字符

适用场景

  1. 01避免 API 密钥进入仓库历史
  2. 02为 Firecrawl 或 Brave Search 提供凭据
  3. 03启动需要环境变量的 MCP 服务

MCP 相关

它会在启动 MCP 服务命令前加载配置的凭据,充当命令包装器。项目未说明它会向客户端提供自身工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"get-mcp-keys": {
"command": "npx",
"args": [
"-y",
"firecrawl-mcp"
],
"env": {
"FIRECRAWL_API_KEY": "<FIRECRAWL_API_KEY>"
}
}
}
}
启动命令npx -y firecrawl-mcp
需要配置的环境变量
FIRECRAWL_API_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmfirecrawl-mcp

工具

27

收录的工具列表 · 更新于 3 周前

参数类型必填说明
urlstring是
formatsarray否
jsonOptionsobject否
jsonOptions.promptstring否
jsonOptions.schemaobject否
queryOptionsobject否
queryOptions.promptstring是
queryOptions.modeenum否directQuote | freeform
screenshotOptionsobject否
screenshotOptions.fullPageboolean否
screenshotOptions.qualitynumber否
screenshotOptions.viewportobject否
screenshotOptions.viewport.widthnumber是
screenshotOptions.viewport.heightnumber是
parsersarray否
pdfOptionsobject否
pdfOptions.maxPagesinteger否
onlyMainContentboolean否
redactPIIboolean否
includeTagsarray否
excludeTagsarray否
waitFornumber否
actionsarray否
mobileboolean否
skipTlsVerificationboolean否
removeBase64Imagesboolean否
locationobject否
location.countrystring否
location.languagesarray否
storeInCacheboolean否
zeroDataRetentionboolean否
maxAgenumber否
lockdownboolean否
proxyenum否basic | stealth | enhanced | auto
profileobject否
profile.namestring是
profile.saveChangesboolean否

详细介绍

🔐 get-mcp-keys

防止意外将 API 密钥提交到代码仓库!

问题

使用 Cursor AI(以及其他 AI 编码助手)和 MCP 服务时,你需要在 ./cursor/mcp.json 文件中配置 API 密钥:

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": [
        "-y",
        "firecrawl-mcp"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "sk_live_ohno-this-should-NOT-be-in-git" // 💀
      }
    }
  }
}

这无异于一场随时可能发生的安全灾难。 一旦不小心提交,密钥就会暴露在 Git 历史记录中。

💯 解决方案

get-mcp-keys 会从你主目录中的安全文件加载 API 密钥,让它们完全远离你的代码仓库。

⚡ 快速开始

1. 在主目录中创建 .mcprc 文件
touch ~/.mcprc
chmod 600 ~/.mcprc  # Make it readable only by you
3. 将 API 密钥添加到文件中
# ~/.mcprc
FIRECRAWL_API_KEY="your_actual_api_key_here"
BRAVE_API_KEY="another_secret_key_here"
# Add any other MCP server keys you use
4. 更新 MCP 配置以使用 get-mcp-keys
{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": [
        "@masonator/get-mcp-keys", // 🔐
        "npx",
        "-y",
        "firecrawl-mcp"
      ]
    }
  }
}

就是这么简单! get-mcp-keys 工具会:

  • 从 ~/.mcprc 加载 API 密钥
  • 将它们注入为环境变量
  • 在密钥可用的情况下运行 MCP 服务命令

🛡️ 安全性

  • API 密钥保存在你的主目录中
  • 密钥绝不会被提交到代码仓库
  • 仅在需要时加载密钥
  • 调试输出仅显示密钥的首尾几个字符

🧰 支持的 MCP 服务

适用于任何需要环境变量的 MCP 服务,包括:

  • FireCrawl
  • Brave Search
  • Supabase
  • 以及你配置的任何其他 MCP 服务!

🔍 工作原理

get-mcp-keys 会读取你的 .mcprc 文件,将其中的环境变量添加到当前环境,然后执行你在参数列表中指定的命令。简单而有效!

get-mcp-keys 实际运行效果

📋 许可证

MIT


⭐ 如果它帮你避免了提交密钥,请为这个代码仓库点个星!

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。