Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client