返回 MCP 目录
public公开dns本地运行

Infisical MCP Server

Infisical的Model Context Protocol(MCP)服务器提供了一套通过函数调用与Infisical API集成的工具,支持创建、删除、更新和查询密钥等操作,适用于密钥管理和项目协作。

article

README

🚀 Infisical 模型上下文协议服务器

Infisical 模型上下文协议 服务器支持通过函数调用与 Infisical API 集成。该协议为各类工具提供了与 Infisical 交互的能力。

🚀 快速开始

环境变量设置

若要使用 MCP 服务器,需先设置必要的环境变量以完成身份验证:

  • INFISICAL_UNIVERSAL_AUTH_CLIENT_ID:用于身份验证的 Machine Identity 统一身份认证客户端 ID。
  • INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET:用于身份验证的 Machine Identity 统一身份认证客户端密钥。
  • INFISICAL_HOST_URL可选,可设置自定义主机 URL,适用于自托管 Infisical 或专用基础设施,默认为 https://app.infisical.com

使用 npx 运行 Infisical MCP 服务器:

npx -y @infisical/mcp

在 Claude Desktop 中使用

在您的 claude_desktop_config.json 文件中添加以下内容。更多细节请参考此处

{
  "mcpServers": {
    "infisical": {
      "command": "npx",
      "args": ["-y", "@infisical/mcp"],
      "env": {
        "INFISICAL_HOST_URL": "https://<自定义主机 URL>.com", // 可选
        "INFISICAL_UNIVERSAL_AUTH_CLIENT_ID": "<machine-identity-universal-auth-client-id>",
        "INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET": "<machine-identity-universal-auth-client-secret"
      }
    }
  }
}

✨ 主要特性

可用工具

| 工具 | 描述 | | --------------------------- | -------------------------------- | | create-secret | 创建新的秘密 | | delete-secret | 删除秘密 | | update-secret | 更新秘密 | | list-secrets | 列出所有秘密 | | get-secret | 获取单个秘密 | | create-project | 创建新项目 | | create-environment | 创建新的环境 | | create-folder | 创建新的文件夹 | | invite-members-to-project | 邀请一个或多个成员加入项目 |

🔧 技术细节

调试服务器

若要调试服务器,可使用MCP 检查器

操作步骤

  1. 构建服务器:
npm run build
  1. 在终端中运行以下命令启动 MCP 检查器和服务器:
# 启动 MCP 检查器和服务器
npx @modelcontextprotocol/inspector node dist/index.js
  1. 设置环境变量,参考环境变量设置部分。
  2. 运行命令以启动 MCP 检查器。
  3. 在浏览器中打开 MCP 检查器 UI 并点击“连接”以启动 MCP 服务器。
  4. 您可以看到所有可用工具并逐一测试。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端