Infisical Model Context Protocol

Infisical Model Context Protocol

Infisical Model Context Protocol 服务允许你通过函数调用集成 Infisical API。此协议支持多种与 Infisical 交互的工具。

设置

环境变量

要使用 MCP 服务，你必须先设置身份验证所需的环境变量。

• INFISICAL_AUTH_METHOD：要使用的身份验证方法。支持的值为 universal-auth 和 access-token。默认为 universal-auth。
• INFISICAL_UNIVERSAL_AUTH_CLIENT_ID：Machine Identity universal auth 客户端 ID。当 INFISICAL_AUTH_METHOD 为 universal-auth 时必需。
• INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET：Machine Identity universal auth 客户端密钥。当 INFISICAL_AUTH_METHOD 为 universal-auth 时必需。
• INFISICAL_TOKEN：用于身份验证的访问令牌。可以是个人访问令牌，也可以是 Machine Identity 访问令牌。当 INFISICAL_AUTH_METHOD 为 access-token 时必需。
• INFISICAL_HOST_URL：可选设置自定义主机 URL。如果你可自托管 Infisical，或使用专用基础设施，这会很有用。默认为 https://app.infisical.com。

有关限制可用工具以及是否返回密钥值的两个可选变量，请参阅限制服务公开的内容。

要使用 npx 运行 Infisical MCP 服务，请使用以下命令：

npx -y @infisical/mcp

与 Claude Desktop 配合使用

将以下内容添加到 claude_desktop_config.json。更多详情请参阅此处。

Universal Auth（默认）

{
  "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>"
      }
    }
  }
}

Access Token

{
  "mcpServers": {
    "infisical": {
      "command": "npx",
      "args": ["-y", "@infisical/mcp"],
      "env": {
        "INFISICAL_HOST_URL": "https://<custom-host-url>.com",
        "INFISICAL_AUTH_METHOD": "access-token",
        "INFISICAL_TOKEN": "<your-access-token>"
      }
    }
  }
}

可用工具

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

限制服务公开的内容

这两个变量均为可选项，默认值会保留服务的现有行为。

• INFISICAL_ENABLED_TOOLS：以逗号分隔的工具允许列表，用于指定要公开的工具；请使用上表中的工具名称（例如，设为 list-projects,list-secrets,get-secret 即可创建只读服务）。未列出的工具不会出现在 tools/list 中，且调用时会被拒绝。未知名称会导致启动失败。不设置此变量则公开所有工具。
• INFISICAL_MASK_SECRET_VALUES：true 或 false，不区分大小写。默认为 false。设为 true 时，工具响应中的密钥值会替换为 <masked>，避免密钥材料进入模型上下文。密钥名称、路径和其他元数据仍会返回。

请将 Machine Identity 的访问范围限制为服务所需的项目和环境，而不要使用权限范围大于已公开工具所需范围的令牌。

调试服务

要调试服务，可以使用 MCP Inspector。

首先构建服务

npm run build

在终端中运行以下命令：

# Start MCP Inspector and server
npx @modelcontextprotocol/inspector node dist/index.js

说明

1. 按照环境变量步骤中的说明设置环境变量。
2. 运行命令以启动 MCP Inspector。
3. 在浏览器中打开 MCP Inspector UI，然后点击 Connect 以启动 MCP 服务。
4. 你可以查看所有可用工具，并逐一测试。