Claude Https MCP

Claude HTTPS MCP工具

MCP（模型上下文协议）服务器，为Claude Code提供安全的HTTPS获取工具，并从JSON配置文件加载自定义TLS配置。

特性

免费功能

• TLS版本控制：配置最低和最高TLS版本（TLS 1.2、TLS 1.3）
• 密码套件配置文件：现代、中级、兼容或自定义密码套件
• CA证书模式：捆绑的Mozilla CA捆绑包、操作系统信任存储或自定义CA路径
• 代理支持：具有基本身份验证的HTTP代理
• 可配置超时：请求超时配置

专业功能（需要许可证）

• 双向TLS：使用客户端证书对API进行身份验证
• 证书固定：按叶、中间、根证书或SPKI哈希进行Pin
• FIPS合规性：政府、医疗保健和金融部门需要FIPS 140-3验证的加密技术
• 证书吊销：基本吊销检查（OCSP+CRL）是免费的

安装

先决条件

• Node.js 18或更高版本 --检查一下 node --version
• 克劳德代码 （CLI）-已安装并经过身份验证

步骤1：安装软件包

npm install -g claude-https-mcp

步骤2：使用Claude Code注册MCP服务器

claude mcp add --scope user --transport stdio cyphers-ai -- claude-https-mcp

关于 --scope user: 这将为您的用户帐户注册该工具，使其在每个项目中都可用。使用 --scope project 相反，如果您只希望它在当前项目中可用（这会写入项目的 .mcp.json 而不是您的全局配置）。省略 --scope 完全以交互方式提示。

步骤3：配置

该工具从以下位置读取其配置 ~/.claude/https-config.json。您必须先创建此文件，然后该工具才能处理默认值之外的任何内容。

mkdir -p ~/.claude
cp node_modules/claude-https-mcp/example-config.json ~/.claude/https-config.json

然后编辑 ~/.claude/https-config.json 以适应您的环境。至少要审查：

• tls.cipherProfile — "intermediate" 对于大多数用例来说，这是一个很好的默认值
• ca.mode — "bundled" 使用附带的Mozilla CA捆绑包；使用 "osPlusBundled" 如果您需要信任操作系统存储中的内部CA
• proxy --如果您支持公司代理，请设置 enabled: true 并提供代理URL

看 配置选项 请参阅以下部分以获取完整参考，或 example-config.json 作为注释示例。

步骤4：验证

claude mcp list

你应该看看 cyphers-ai 在输出中。启动一个新的Claude Code会话 SecureWebFetch 工具将可用。

更新中

要更新到最新版本：

npm update -g claude-https-mcp

无需对Claude Code注册或配置文件进行任何更改，更新的二进制文件将自动获取。

替代方案：npx（零安装）

如果您不想全局安装，可以使用 npx 按需运行该工具。Claude Code每次启动会话时都会下载最新版本：

claude mcp add --scope user --transport stdio cyphers-ai -- npx claude-https-mcp

这便于尝试该工具，但在每次会话中都会增加几秒钟的启动延迟 npx 解析包。对于常规使用，建议全局安装。

您仍然需要在以下位置创建配置文件 ~/.claude/https-config.json 如步骤3所述。

备选方案：来源

git clone https://github.com/cyphers-ai/claude-https-mcp.git
cd claude-https-mcp
npm install
npm run build
npm link
claude mcp add --scope user --transport stdio cyphers-ai -- claude-https-mcp

配置

配置文件位于 ~/.claude/https-config.json （或用覆盖路径 CLAUDE_HTTPS_CONFIG 环境变量）。以下是具有默认值的完整模式：

{
  "tls": {
    "minVersion": "TLSv1.2",
    "maxVersion": "TLSv1.3",
    "cipherProfile": "intermediate",
    "customCiphers": null,
    "rejectUnauthorized": true
  },
  "ca": {
    "mode": "bundled",
    "customBundlePaths": [],
    "additionalCaPaths": []
  },
  "clientCert": {
    "enabled": false,
    "certPath": null,
    "keyPath": null,
    "passphrase": null,
    "p12Path": null,
    "p12Passphrase": null
  },
  "pinning": {
    "enabled": false,
    "mode": "leaf",
    "pins": []
  },
  "revocation": {
    "enabled": false,
    "policy": "ocspWithCrlFallback",
    "failMode": "soft",
    "cacheTtlSeconds": 300
  },
  "proxy": {
    "enabled": false,
    "url": null,
    "auth": {
      "type": "none",
      "username": null,
      "password": null
    },
    "bypassList": []
  },
  "defaults": {
    "timeoutMs": 30000,
    "followRedirects": true,
    "maxRedirects": 10,
    "maxBodySizeBytes": 10485760
  },
  "license": {
    "key": null
  }
}

看 example-config.json 一个完整记录的例子。

配置选项

TLS设置

CA模式

密码配置文件

用法

配置后，Claude Code将可以访问 SecureWebFetch 工具：

Use SecureWebFetch to get https://api.example.com/data

工具参数

环境变量

许可证

• 无需许可证即可使用免费功能
• 专业版功能需要以下许可证https://cyphers.ai

发展

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

测试

# Run unit tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage report
npm run test:coverage

集成测试

集成测试套件使用Docker来启动TLS测试端点（mTLS、OCSP、CRL、过期证书等）：

npm run test:server:start   # Start Docker test environment
npm run test:server:test    # Run integration tests
npm run test:server:stop    # Stop Docker test environment