关于 🔐 get-mcp-keys
get-mcp-keys 面向使用 Cursor 等 AI 编码工具的开发者,从 `~/.mcprc` 读取密钥并注入环境变量,再运行 MCP 服务命令,避免在仓库中保存凭据。
主要功能
- 01从 `~/.mcprc` 加载密钥
- 02将密钥注入环境变量
- 03运行配置的 MCP 服务命令
- 04调试输出隐藏密钥大部分字符
适用场景
- 01避免 API 密钥进入仓库历史
- 02为 Firecrawl 或 Brave Search 提供凭据
- 03启动需要环境变量的 MCP 服务
MCP 相关
它会在启动 MCP 服务命令前加载配置的凭据,充当命令包装器。项目未说明它会向客户端提供自身工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
27收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | |
| formats | array | 否 | |
| jsonOptions | object | 否 | |
| jsonOptions.prompt | string | 否 | |
| jsonOptions.schema | object | 否 | |
| queryOptions | object | 否 | |
| queryOptions.prompt | string | 是 | |
| queryOptions.mode | enum | 否 | directQuote | freeform |
| screenshotOptions | object | 否 | |
| screenshotOptions.fullPage | boolean | 否 | |
| screenshotOptions.quality | number | 否 | |
| screenshotOptions.viewport | object | 否 | |
| screenshotOptions.viewport.width | number | 是 | |
| screenshotOptions.viewport.height | number | 是 | |
| parsers | array | 否 | |
| pdfOptions | object | 否 | |
| pdfOptions.maxPages | integer | 否 | |
| onlyMainContent | boolean | 否 | |
| redactPII | boolean | 否 | |
| includeTags | array | 否 | |
| excludeTags | array | 否 | |
| waitFor | number | 否 | |
| actions | array | 否 | |
| mobile | boolean | 否 | |
| skipTlsVerification | boolean | 否 | |
| removeBase64Images | boolean | 否 | |
| location | object | 否 | |
| location.country | string | 否 | |
| location.languages | array | 否 | |
| storeInCache | boolean | 否 | |
| zeroDataRetention | boolean | 否 | |
| maxAge | number | 否 | |
| lockdown | boolean | 否 | |
| proxy | enum | 否 | basic | stealth | enhanced | auto |
| profile | object | 否 | |
| profile.name | string | 是 | |
| profile.saveChanges | boolean | 否 |
详细介绍
🔐 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 文件,将其中的环境变量添加到当前环境,然后执行你在参数列表中指定的命令。简单而有效!

📋 许可证
MIT
⭐ 如果它帮你避免了提交密钥,请为这个代码仓库点个星!
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。