Infisical 模型上下文协议

Infisical 模型上下文协议 (Model Context Protocol) 服务器允许你通过函数调用与 Infisical API 集成。该协议支持多种工具来与 Infisical 进行交互。

设置

环境变量

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

• INFISICAL_AUTH_METHOD: 要使用的身份验证方法。支持的值为 universal-auth 和 access-token。默认为 universal-auth。

• INFISICAL_UNIVERSAL_AUTH_CLIENT_ID: 机器身份通用认证客户端 ID。当 INFISICAL_AUTH_METHOD 为 universal-auth 时必需。

• INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET: 机器身份通用认证客户端密钥。当 INFISICAL_AUTH_METHOD 为 universal-auth 时必需。

• INFISICAL_TOKEN: 用于身份验证的访问令牌。这可以是个人访问令牌或机器身份访问令牌。当 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 中。有关更多详细信息，请参阅此处。

通用认证 (默认)

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

访问令牌

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

Related MCP server: OpenAPI MCP Server

可用工具

调试服务器

要调试你的服务器，可以使用 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，然后点击“连接”以启动 MCP 服务器。

4. 你可以看到所有可用的工具并单独测试它们。