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

infisical-mcp-server

Infisical Model Context Protocol (MCP) 是一个通过函数调用与Infisical API集成的服务协议,支持多种工具操作如创建、删除、更新密钥等,并提供调试工具MCP Inspector。

article

README

🚀 信息素模型上下文协议服务器

信息素模型上下文协议服务器为用户提供了便捷的密钥管理和项目操作功能,通过设置环境变量进行身份验证,可在不同环境下灵活使用,还能借助相关工具进行调试和操作。

🚀 快速开始

要使用信息素 MCP 服务器,必须首先设置用于身份验证所需的环境变量。以下是需要设置的环境变量及其说明:

  • INFISICAL_UNIVERSAL_AUTH_CLIENT_ID:用于身份验证的机器标识符通用身份验证客户端 ID。
  • INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET:用于身份验证的机器标识符通用身份验证客户端密钥。
  • INFISICAL_HOST_URL可选 设置自定义主机 URL。这在自托管信息素或使用专用基础设施时很有用,默认为 https://app.infisical.com

使用 npx 运行信息素 MCP 服务器的命令如下:

npx -y @infisical/mcp

📦 安装指南

在 Claude Desktop 上使用

将以下内容添加到你的 claude_desktop_config.json 文件中。有关更多详细信息,请参见 此处

{
  "mcpServers": {
    "infisical": {
      "command": "npx",
      "args": ["-y", "@infisical/mcp"],
      "env": {
        "INFISICAL_HOST_URL": "https://<custom-host-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 检查器和服务器
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. 补齐环境变量后重启客户端