克劳德桌面MCP桥

通过模型上下文协议（MCP）将Claude代码功能引入Claude桌面

问题陈述

Claude Desktop和Claude Code提供了不同的功能：

克劳德桌面：通用人工智能助手，本地系统访问受限
克劳德代码：具有文件系统访问、shell命令和广泛技能库的完整开发环境

为什么要强迫用户选择？ 如果Claude Desktop可以访问Docker，那么它就没有技术原因不能通过MCP访问与Claude Code相同的工具。

视觉

创建向Claude Desktop公开Claude Code功能的MCP服务器，启用：

✅ 文件操作（读、写、编辑）
✅ Shell命令执行
✅ 代码搜索和导航
✅ 技能库集成
✅ 任务管理系统
✅ 持久记忆和学习

建筑

Claude Desktop → MCP Client → MCP Bridge Servers → Local System
                                    ↓
                            [filesystem-bridge]
                            [shell-bridge]
                            [skills-bridge]
                            [compliance-bridge]  ← SOC2-lite compliance scanner
                            [task-bridge]

MCP服务器

1. 📁 `filesystem-bridge` ✅ 完成

暴露Claude Code的文件操作：

read_file() -读取任何有行号的文件
write_file() -创建新文件
edit_file() -精确的字符串替换
glob_search() -基于模式的文件查找

2. 🖥️ `shell-bridge` ✅ 完成

提供安全的shell访问：

run_command() -执行bash/cmd命令
run_background() -后台流程管理
get_current_directory(), change_directory() -导航
安全控制和超时

3. 🧠 `skills-bridge` ✅ 完成

揭露克劳德密码 整个22技能库:

list_skills() -按类别浏览所有可用技能
find_skills() -按关键字/触发器搜索技能
apply_skill() -将特定技能应用于你的任务
auto_skill_match() -自动查找并应用最佳技能

可用技能：

⭐ 大师技能（4）： 超前端、超后端、超全栈、超CSS
🏆 精英技能（4）： 调试器大师、超级架构师、干净代码、自学
💡 标准技能（14）： AI Agent Builder、LLM Trainer、测试自动化、DevOps CI/CD、数据工程、Web Scraping、API开发、数据库管理、安全测试、MLOps、云基础设施、监控和可观察性、知识库生成器、MCP生成器

4. `compliance-bridge` （合规导航）

Compliance Navigator将MCP从工具管道转变为结构化的合规工作流引擎。

在9个工具中使用交互式仪表板进行SOC2-lite扫描——扫描仓库，生成审计支持包，获取优先修复计划，并创建跟踪工作项（GitHub Issues或Jira）。通过严格的命令allowlist运行gitleaks（secrets）、npm audit（dependency）和checkov（IaC），将发现映射到20个SOC2 Trust Services控件，并提供补救ROI估计。

重要：此工具有助于合规工作流程，但不会取代SOC2审计。扫描仪的发现表明了潜在的控制差距——它们并不能证明控制措施得到了实施。覆盖率反映的是扫描仪的覆盖范围，而不是审计员验证的合规状态。投资回报率估计使用可配置的行业知情默认值，而不是测量数据。所有输出在用于正式合规流程之前，应由合格人员进行审查。

快速入门

npm install && npm run build

添加到克劳德桌面MCP配置(claude_desktop_config.json):

{
  "compliance-bridge": {
    "command": "node",
    "args": ["./dist/compliance-bridge/server.js"]
  }
}

然后问克劳德： *“在此仓库上运行合规性扫描”* --或直接调用工具：

// 1. Scan
{"method":"tools/call","params":{"name":"compliance.scan_repo","arguments":{"repoPath":"/path/to/repo"}}}

// Response includes:
// findings[], countsBySeverity, countsByScanner, controlCoverage{coveragePct, coveragePctPotential, coveragePctFull},
// roiEstimate{hoursSavedConservative, hoursSavedLikely}, scannerStatuses[], manifest{policy, excludedPaths}

// 2. Generate audit packet
{"method":"tools/call","params":{"name":"compliance.generate_audit_packet","arguments":{"repoPath":"/path/to/repo"}}}

// 3. Get remediation plan
{"method":"tools/call","params":{"name":"compliance.plan_remediation","arguments":{"repoPath":"/path/to/repo"}}}

输出示例 （针对包含故意漏洞的演示回购）：发现数组，包括严重性/扫描程序/SOC2映射、控制覆盖率和ROI估计。真实世界的结果取决于您的代码库和安装的扫描仪。

闭环票创建

通过安全的模拟运行/批准/执行流程将调查结果转化为跟踪的工作项：

// Step 1: Dry-run -- preview what would be created (no side effects)
{"method":"tools/call","params":{"name":"compliance.create_tickets","arguments":{
  "repoPath":"/path/to/repo", "dryRun": true
}}}
// Response: planId, wouldCreate[], skippedAsDuplicate[]

// Step 2: Approve the plan (file-based, hash-verified)
{"method":"tools/call","params":{"name":"compliance.approve_ticket_plan","arguments":{
  "repoPath":"/path/to/repo", "planId":"
", "approvedBy":"security-lead"
}}}

// Step 3: Execute -- creates real GitHub Issues
{"method":"tools/call","params":{"name":"compliance.create_tickets","arguments":{
  "repoPath":"/path/to/repo", "dryRun": false, "approvedPlanId":"
"
}}}
// Response: created[{url, number}], summary{requested, created, duplicates, reopened}

单线演示 （扫描+数据包+模拟票）：

scan_repo → generate_audit_packet → create_tickets(dryRun=true) → approve → create_tickets(dryRun=false)

安全和控制功能：

去重: CN-FINDING-ID 问题正文中的标记可防止跨运行的重复问题
审批门：内置回购标识的SHA-256哈希绑定计划（防止跨回购重播）
reopenClosed：可选择重新打开已关闭的重复问题，而不是跳过
标签政策: require-existing （安全默认）仅使用已存在的标签； create-if-missing 自动创建它们
速率限制：GitHub/Jira API 403/429响应的自动退避 X-RateLimit-Remaining 监控
审计跟踪：将每次模拟运行、批准和执行记录到哈希链审计日志中

合规仪表板（MCP应用程序）

在Claude Desktop或任何支持资源的MCP客户端中打开交互式仪表板：

// Open dashboard for a repo
{"method":"tools/call","params":{"name":"compliance.open_dashboard","arguments":{"repoPath":"/path/to/repo"}}}
// Response: { resourceUri: "compliance://dashboard?repoPath=..." }

// Render via resources/read
{"method":"resources/read","params":{"uri":"compliance://dashboard?repoPath=/path/to/repo"}}
// Response: HTML with id="cn-dashboard" containing the full workflow UI

仪表板提供：

工作流程步骤：扫描→ 审计数据包→ 补救计划→ 门票（试运行）→ 批准→ 执行
调查结果表 具有严重性、扫描程序、文件和SOC2控制映射
证据小组 具有扫描仪状态、覆盖范围（扫描仪覆盖范围）、ROI估计和清单
审核日志查看器 使用哈希链验证

如果 GH_TOKEN 如果未设置，工单创建按钮将被禁用，并显示一条明确的消息。

演示夹具生成器

创建一个独立的演示仓库，其中包含所有3个扫描仪的有意发现：

# Via MCP tool
compliance.create_demo_fixture({ outputDir: "/tmp/demo-repo" })

# Then scan it
compliance.scan_repo({ repoPath: "/tmp/demo-repo" })

生成伪造的AWS密钥（gitleaks）、易受攻击的npm deps（npm审计）、不安全的Terraform+Dockerfile（checkov）。所有秘密都明确标记为仅供测试。

ZIP导出

将审计数据包导出为具有SHA-256完整性验证的便携式ZIP存档：

// Export the latest audit packet as a ZIP
{"method":"tools/call","params":{"name":"compliance.export_audit_packet","arguments":{
  "repoPath":"/path/to/repo"
}}}
// Response: { zipPath, bytes, sha256, runId, includesEvidence }

// Export without raw scanner evidence (smaller file)
{"method":"tools/call","params":{"name":"compliance.export_audit_packet","arguments":{
  "repoPath":"/path/to/repo", "includeEvidence": false
}}}

ZIP被写入 .compliance/exports//audit_packet.zip 并且其SHA-256散列被记录在审计链中。适用于CI工件上传、电子邮件传递或归档。

CI/CD集成（GitHub操作）

对每个推送或拉取请求自动运行合规性扫描：

# Run locally via the CI runner (report-only by default)
npm run ci:compliance -- --repo-path .

# Fail build on critical findings
npm run ci:compliance -- --repo-path . --fail-on critical

# Scan + ticket dry-run
npm run ci:compliance -- --repo-path . --create-tickets --dry-run

# Scan + ticket execution (requires prior approval)
npm run ci:compliance -- --repo-path . --create-tickets --approved-plan-id

可重用的GitHub Action工作流包含在 .github/workflows/compliance.yml:

推/公关：扫描+导出ZIP+上传为GitHub Actions工件（无票，永远）
workflow_dispatch：扫描+导出+可选票证创建（需要显式 createTickets=true 输入）

机器可读摘要写入 .compliance/ci/summary.json 用于下游加工。

安全模型

这些不变量适用于每次扫描：

命令在执行前经过argv验证。 只有6个正则表达式模式通过allowlist： gitleaks detect, npm audit, checkov -d，以及他们 --version 探头。其他东西都扔了。
没有任意的shell评估。 在Linux/macOS上，扫描程序会生成 shell: false （直接执行）。在Windows上， .exe 二进制文件（gitleaks、checkov）也使用 shell: false；仅 .cmd （npm）需要 shell: true，用cmd元字符拒绝进行强化(& | ^ % ! 屏蔽）和双引号净化。清单记录了每种扫描仪外壳模式。
所有写作仅限于 /.compliance/. 路径策略根据回购根验证每个写入目标。目录遍历(../)被封锁了。
带有内置验证器的哈希链审计日志。 每次工具调用（开始、结束、命令运行、文件写入）都会记录到 logs/compliance-audit-chain.jsonl 使用SHA-256哈希链。每个条目包括 prevHash 和 hashThe compliance.verify_audit_chain 该工具重新计算每个哈希值，并用第一条虚线报告PASS/FAIL。
自我记录清单。 每个审计数据包包括 manifest.json 记录：允许的命令、shell执行模式、排除的扫描路径、扫描程序版本、操作系统、节点版本和仓库提交哈希。无需访问服务器代码，即可对数据包进行审查。

输出结构

/.compliance/
  runs//
    scan_result.json          # Full scan data
    evidence/
      gitleaks.json           # Raw scanner output
      npm-audit.json
      checkov.json
    audit_packet/
      index.md                # Executive summary + scorecard
      findings.json           # Normalized findings
      coverage.json           # SOC2 control coverage
      roi.json                # ROI estimate
      manifest.json           # Deterministic export metadata + security policy
      evidence/               # Copies of raw outputs
  exports//
    audit_packet.zip          # Portable ZIP archive (SHA-256 recorded in audit chain)
  approvals/
    pending/
.json     # Dry-run ticket plans awaiting approval
    approved/
.json    # Approved plans (hash-verified at execution time)

5. `task-bridge` （计划中）

任务管理系统：

create_task(), update_task(), list_tasks()
进度跟踪和依赖关系
后台任务监控

6. `search-bridge` （计划中）

高级代码搜索：

grep_search() -使用正则表达式进行内容搜索
code_analysis() -语义代码理解
支持多文件重构

快速开始

先决条件

支持MCP的Claude桌面
Node.js 18+或Python 3.8+
Git

安装

# Clone the repository
git clone https://github.com/rblake2320/claude-desktop-mcp-bridge.git
cd claude-desktop-mcp-bridge

# Install dependencies
npm install  # or pip install -r requirements.txt

# Build MCP servers
npm run build

# Configure Claude Desktop
# Add to your Claude Desktop MCP settings:
{
  "mcpServers": {
    "filesystem-bridge": {
      "command": "node",
      "args": ["./dist/filesystem-bridge.js"],
      "env": {
        "ALLOWED_PATHS": "/path/to/your/projects"
      }
    },
    "shell-bridge": {
      "command": "node",
      "args": ["./dist/shell-bridge.js"]
    },
    "skills-bridge": {
      "command": "node",
      "args": ["./dist/skills-bridge.js"]
    }
  }
}

发展

仓库结构

claude-desktop-mcp-bridge/
├── src/
│   ├── filesystem-bridge/    # File operations MCP server
│   ├── shell-bridge/         # Shell command MCP server
│   ├── skills-bridge/        # Skills library MCP server
│   ├── compliance-bridge/    # SOC2 audit engine (gitleaks + npm audit + checkov)
│   │   ├── server.ts         # MCP server with 9 tools
│   │   ├── contracts.ts      # All TypeScript types
│   │   ├── schemas.ts        # Zod validation schemas
│   │   ├── ticket-writer.ts  # GitHub Issues integration (dry-run/approve/execute)
│   │   ├── normalizers/      # Scanner output parsers (gitleaks, npm-audit, checkov)
│   │   ├── soc2-map.ts       # 20-control SOC2 mapping
│   │   ├── roi.ts            # ROI estimation model
│   │   └── audit-packet.ts   # Structured audit-support packet generator
│   ├── task-bridge/          # Task management MCP server
│   └── shared/               # Shared utilities (command-allowlist, path-policy, audit-chain)
├── .gitleaks.toml            # Gitleaks exclusion config (dist/, node_modules/)
├── .gitleaksignore           # Fingerprint-based false positive suppression
├── tests/                    # Test suites
├── docs/                     # Documentation
├── examples/                 # Example configurations
└── scripts/                  # Build and deployment scripts

贡献

克隆该仓库
创建要素分支： git checkout -b feature/amazing-feature
进行更改并彻底测试
承诺： git commit -m 'Add amazing feature'
推： git push origin feature/amazing-feature
打开拉取请求

路线图

\[ \] 第一阶段：基本文件系统和shell MCP服务器
\[ \] 第2阶段：技能库集成
\[ \] 第三期：任务管理系统
\[ \] 阶段4：高级搜索和代码分析
\[ \] 阶段5：持久记忆和学习
\[ \] 第6阶段：Docker和远程系统支持

安全注意事项

🔒 最小权限原则：可配置的允许路径和命令
🛡️ 输入验证：所有用户输入都经过净化和验证
⏱️ 超时：命令具有可配置的执行超时
📝 审核日志记录：记录所有操作以供安全审查
🚫 安全默认值：默认情况下为只读模式，写访问需要显式配置

🏪 技能市场准备就绪

这座桥包括 动态技能加载基础设施 专为安全第一技能市场设计。

信任级别和安全模型

我们的安全第一方法使用 基于信任的隔离 安全地整合社区技能：

信任级别	描述	需要批准	资源限制	示例
🔒 系统	内置核心功能	无	无限制	超级前端，主调试器
✅ 已验证	数字签名可信技能	无	标准（64MB，30s）	json格式化程序
⚠️ 不可信的	社区捐款	用户批准	严格（128MB，45秒）	网址检查器

目录结构

技能存在于具有自动发现功能的标准化目录结构中：

~/.claude/skills/
├── .approvals/           # Approval workflow state
├── .cache/              # Discovery and validation cache
├── built-in/            # Legacy 22-skill library (preserved)
├── verified/            # Signed, trusted skills
│   └── json-formatter/  # ✅ Example: loads immediately
│       ├── skill-manifest.json
│       └── skill.ts
├── untrusted/           # Community skills requiring approval
│   └── url-checker/     # ⚠️ Example: requires user approval
│       ├── skill-manifest.json
│       └── skill.ts
└── README.md           # Golden-path examples and documentation

审批工作流程

信任体系提供 安全社区技能整合:

发现：技能自动从中发现 verified/ 和 untrusted/ 目录
安全扫描：对代码进行危险模式分析（eval、exec、文件删除）
信任验证：已检查签名，已应用资源限制
审批门：不可信技能在加载前提示用户
运行时隔离：每项技能都在受控环境中运行

经过验证的技能 立即加载， 不可信的技能 需要一次性用户批准。

快速入门：创造你的第一项技能

# 1. Copy the golden-path example
mkdir -p ~/.claude/skills/verified/my-skill
cp ~/.claude/skills/verified/json-formatter/* ~/.claude/skills/verified/my-skill/

# 2. Edit the manifest
cat > ~/.claude/skills/verified/my-skill/skill-manifest.json  ~/.claude/skills/verified/my-skill/skill.ts ';
}
EOF

# 4. Update integrity hash
cd ~/.claude/skills
node -e "
  const crypto = require('crypto');
  const fs = require('fs');
  const manifest = JSON.parse(fs.readFileSync('verified/my-skill/skill-manifest.json'));
  const skillCode = fs.readFileSync('verified/my-skill/skill.ts');
  manifest.integrity_hash = crypto.createHash('sha256').update(skillCode).digest('hex');
  fs.writeFileSync('verified/my-skill/skill-manifest.json', JSON.stringify(manifest, null, 2));
  console.log('✅ Skill ready!');
"

# 5. Test with skill doctor
./verify-examples.sh  # Validates your new skill

安全模型基本原理

为什么要进行基于信任的隔离？

🔒 低摩擦可信技能：系统和经过验证的技能永远不会提示用户
🚀 创新友好：社区可以自由贡献不可信的技能
🛡️ 用户控件：明确风险操作的审批流程
📈 可扩展的：路由器模式实现了无限制的技能，而不会造成上下文膨胀
🏪 市场就绪：技能出版商和货币化基础

基础设施

向后兼容的：保留和增强所有22项传统技能 路由器模式：按需加载技能，防止上下文溢出 缓存系统：使用SQLite+FTS5内存引擎快速发现 审计跟踪：记录所有技能操作以确保合规 资源管理：每个信任级别的可配置限制

集成点

为技能市场出版商做好准备：

// Skill discovery API
const skills = await discoverSkills(['verified', 'untrusted']);

// Trust validation
const trustStatus = await validateSkillTrust(skillPath);

// Runtime isolation
const result = await executeSkill(skillName, args, {
  memoryLimit: '64MB',
  timeout: 30000,
  networkAccess: false
});

了解更多:

______________________________________________________________________

许可证

MIT许可证-请参阅许可证文件以获取详细信息。

支持

📖 文档
🐛 问题追踪
💬 讨论

灵感

这个项目的灵感来自这样一个认识，即如果Claude Desktop可以访问Docker，那么它就没有技术上的理由不能通过MCP拥有与Claude Code相同的功能。让我们弥合这一差距！

______________________________________________________________________

⭐ 如果您希望Claude Desktop具有Claude Code功能，请启用此存储库！

Claude Desktop MCP Bridge

快速接入

详细介绍