Claude Client Installer

Claude客户端安装程序

⚠️ 已弃用：此存储库已弃用。请使用 claude客户端部署模板 对于新的部署。 看 抑郁.md 获取迁移说明。

使用预配置的MCP服务器为不同的客户端生成定制的Claude Desktop/Code安装包。

概述

这是一个基于脚本的安装程序框架，用于创建 特定于客户端的安装包每个客户端都有一个脚本，用于安装Claude Desktop、Claude Code CLI、MCP Bridge及其特定的MCP服务器——所有这些都是预先配置好的，可以随时使用。

主要特点

• 一个命令安装：客户端运行一个脚本，获得一个完全配置的Claude环境
• 客户端特定配置：每个客户端只获得他们需要的MCP服务器
• 交叉平台的：生成Windows（.bat）和Unix（.sh）安装程序
• 版本受控：在单独的私有存储库中跟踪客户端配置文件
• 安全：敏感凭据保存在私有仓库中，从不保存在公共代码中
• 可维护性：更新基本模板，重新生成所有客户端安装程序

建筑

┌─────────────────────────────────────────┐
│  claude-client-installer (this repo)    │
│  └─ Framework, templates, generator     │
│     - Public/shareable code             │
│     - No sensitive data                 │
└─────────────────────────────────────────┘
             │
             ├─ generates
             ▼
┌─────────────────────────────────────────┐
│  Custom Client Installer                │
│  └─ install-{client}.bat/.sh            │
│     - Claude Desktop install            │
│     - Claude Code CLI install           │
│     - MCP Bridge setup                  │
│     - Client-specific MCPs              │
└─────────────────────────────────────────┘
             │
             ├─ references configs from
             ▼
┌─────────────────────────────────────────┐
│  claude-client-configs (private repo)   │
│  └─ Real client profiles with tokens    │
│     - PRIVATE repository                │
│     - Contains authentication secrets   │
└─────────────────────────────────────────┘

快速开始

先决条件

• Node.js 18+
• Git
• 访问私人 claude-client-configs 仓库

设置

# Clone this repository
git clone https://github.com/MagicTurtle-s/claude-client-installer.git
cd claude-client-installer

# Install dependencies
npm install

# Clone private configs repo (requires access)
cd ..
git clone https://github.com/MagicTurtle-s/claude-client-configs.git

生成客户端安装程序

cd claude-client-installer

# Generate installer for a specific client
node scripts/generate-installer.js \
  --profile ../claude-client-configs/profiles/client-name.json \
  --output ./dist/client-name/

# Output will be in dist/client-name/
# - install-client-name.bat (Windows)
# - install-client-name.sh (Unix/Mac/Linux)
# - README.md (Client-specific instructions)

交付给客户

# Package the generated installer
cd dist/client-name
zip -r ../client-name-installer.zip .

# Send client-name-installer.zip to the client
# They extract and run install-client-name.bat (Windows) or install-client-name.sh (Unix)

项目结构

claude-client-installer/
├── templates/               # Base installer templates
│   ├── install-base.bat    # Windows installer template
│   ├── install-base.sh     # Unix installer template
│   └── mcp-config-template.json
├── scripts/                 # Generator and validation tools
│   ├── generate-installer.js
│   ├── download-urls.js
│   └── validate-profile.js
├── examples/                # Example client profiles (sanitized)
│   ├── example-client.json
│   └── README.md
├── docs/                    # Documentation
│   ├── CREATING-PROFILES.md
│   ├── DEPLOYMENT-GUIDE.md
│   └── SECURITY.md
├── dist/                    # Generated installers (gitignored)
├── package.json
└── README.md

文档

• 创建客户端配置文件：如何创建客户端配置
• 部署指导：如何将安装程序部署到客户端
• 安全最佳实践：处理敏感凭据

客户端配置文件格式

配置文件存储在单独的 私有存储库 (claude-client-configs).

剖面结构示例：

{
  "client": {
    "name": "Example Corp",
    "contact": "admin@example.com",
    "deployment_date": "2025-11-07"
  },
  "mcps": [
    {
      "name": "asana-mcp-railway",
      "enabled": true,
      "config": {
        "endpoint": "https://asana-mcp-railway-production.up.railway.app",
        "session": "SESSION_TOKEN_HERE"
      }
    },
    {
      "name": "hubspot-mcp-railway",
      "enabled": false
    }
  ],
  "bridge": {
    "enabled": true,
    "debug": false
  }
}

可用的MCP服务器

系统支持以下MCP服务器（单独部署）：

• Asana MCP铁路：任务和项目管理（42个工具）
• SharePoint MCP铁路：跨客户站点的文档管理（11个工具）
• HubSpot MCP铁路：CRM集成（116个工具）
• Neo4j密码MCP：图形数据库查询
• Neo4j内存MCP：知识图存储器

每个客户端配置文件指定要包含哪些MCP。

工作流程

添加新客户端

1. 创建配置文件 在私有回购中：

   cd claude-client-configs
   cp profiles/default.json profiles/new-client.json
   # Edit with client-specific configuration
   git add profiles/new-client.json
   git commit -m "Add New Client profile"
   git push

1. 生成安装程序:

   cd claude-client-installer
   node scripts/generate-installer.js \
     --profile ../claude-client-configs/profiles/new-client.json

1. 测试安装程序 在干净的机器上

1. 交付给客户 通过安全通道

更新客户端配置

1. 更新配置文件 在私有回购中：

   cd claude-client-configs
   # Edit profiles/client-name.json
   git commit -am "Update Client config: add Neo4j MCP"
   git push

1. 重新生成安装程序:

   cd claude-client-installer
   node scripts/generate-installer.js \
     --profile ../claude-client-configs/profiles/client-name.json

1. 发送更新的安装程序 给客户

安全

• 这 公共存储库 不包含敏感凭据
• 真正的证书存在于 私有的 claude-client-configs 仓库
• 生成的安装程序（in dist/)被忽视，应安全交付
• 看 安全.md 详细的安全实践

相关项目

此安装程序系统集成了以下项目：

• 克劳德码MCP桥：将Claude Desktop连接到Claude Code CLI
• Asana MCP铁路：Asana集成
• HubSpot MCP铁路：HubSpot CRM集成
• SharePoint MCP铁路：SharePoint文档管理
• Neo4j MCP铁路v2：图形数据库集成

贡献

这是一个用于客户端部署的私有框架。如果您有权限并希望做出贡献：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

支持

对于问题或疑问：

• GitHub问题: https://github.com/MagicTurtle-s/claude-client-installer/issues
• 文档：参见 docs/ 目录

许可证

MIT许可证-有关详细信息，请参阅许可证文件

______________________________________________________________________

状态：v0.1.0-初始开发 维护者：魔术师Turtle-s 最后更新: 2025-11-07