← 返回目录

Craft Agents

社区

非标准 Server

一个开源的、文档优先的多智能体工作台，支持 Claude 和 MCP 集成。

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 315 / 438
Stars: ★ 7.2k 非常热门
传输方式: stdio（本地进程）
运行环境: Bun · Node.js · Docker
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 5 天前

44FMRS · D

Craft Agents 是一个功能丰富的开源智能体工作台，强调文档优先和来源集成。它提供了强大的功能集，包括多会话管理、来源连接、权限控制、自动化和远程服务器支持。然而，它并非官方 Anthropic 产品，且主要面向需要桌面界面的用户。凭证安全和本地 MCP 隔离方面有考虑，但用户仍需谨慎处理权限和敏感数据。

最强项 · 文档质量 12/20 最弱项 · 可靠性 3/20

可靠性

3/20

安全与权限

10/20

维护活跃度

10/20

文档质量

12/20

安装易用性

9/20

查看各项评分依据

可靠性 3/20: 仅依据 README 与仓库元数据，无法确认该仓库是一个标准 MCP server；缺少 server manifest，也没有 MCP init 和工具列表握手的可核验证据。README 描述的是 Craft Agents 桌面客户端、自定义 WebSocket RPC 服务和 CLI，而非标准的 MCP 端点；虽然提到 --validate-server 等特性，但没有提供真实的 CI 工作流或已提交测试来支撑。按静态校准，缺失证据即扣分，因此可靠性很低。
安全与权限 10/20: 未发现恶意代码、凭据窃取、真实密钥泄露等红线。README 显示凭据采用 AES-256-GCM 加密存储，本地 MCP 子进程会过滤敏感环境变量，并提供 Explore/Ask/Auto 权限模式，默认 Ask。但相关实现未从源码核验；CLI run 默认 allow-all 风险较高，远程服务依赖 token 且 TLS 可选，权限和确认机制的覆盖并不完整，因此给 10 分。
维护活跃度 10/20: 仓库未归档，README 包含 Apache-2.0 许可、CONTRIBUTING、SECURITY、CODE_OF_CONDUCT 和商标声明，显示有维护制度。但缺少可核验的 release 记录、提交频率、issue 响应与依赖更新证据，版本治理和更新路径不明确，因此按 10 分处理：活跃但有治理/版本化缺口。
文档质量 12/20: README 分层且详细，包含安装、CLI、远程服务器、环境变量、TLS、Docker、配置、自动化、故障排查与安全说明，示例丰富，整体文档质量高。但作为 MCP server 评审，缺少 server manifest、工具参数、限制和成本等标准 MCP 文档，也没有主流 MCP 客户端的接入示例，因此扣分。
安装易用性 9/20: 该仓库自身提供一键安装脚本、源码构建、Docker 和 CLI 示例，步骤较清晰，但它是桌面应用/自定义 RPC 服务，不是标准 MCP server。缺少在主流 MCP 客户端中配置该 server 的示例，从准备运行环境到建立 MCP 连接需要自行理解自定义协议，手动且脆弱，因此给 9 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

希望获得更多文档或会话中心化工作流的 Claude 用户
需要在桌面 GUI 中连接多种来源和 MCP 服务器的开发者
希望以无头服务器方式运行智能体并使用 CLI 访问的用户

不适合谁

偏好纯 CLI 工作流且不需要桌面界面的用户
不需要文档中心化或多会话管理的用户
需要官方 Anthropic 支持的用户（此工具是第三方构建）

所需权限

用户可以选择权限模式：探索（只读）、询问后编辑、自动（允许所有）
用户可以连接第三方来源，需要授权或 API 密钥
凭证使用 AES-256-GCM 加密存储

风险与副作用

第三方来源可能需要敏感凭证，存在泄露风险
本地 MCP 服务器以子进程运行时，可能受到环境变量过滤的保护，但配置不当可能导致凭证泄露
作为非官方工具，可能存在稳定性或安全更新不及时的问题

安装接入

准备工作

运行环境：Bun · Node.js · Docker

CRAFT_SERVER_TOKEN 必填密钥用于客户端认证的 Bearer 令牌，可用 `openssl rand -hex 32` 自行生成。

CRAFT_RPC_TLS_KEY 可选密钥 PEM 私钥文件路径，需与证书配套使用。

SLACK_OAUTH_CLIENT_SECRET 可选密钥 Slack OAuth 集成所需的客户端密钥。

LLM_API_KEY 可选密钥 CLI run 命令的通用 API 密钥回退变量，也可用具体提供商的环境变量。

ANTHROPIC_API_KEY 可选密钥 Anthropic 提供商的 API 密钥，用于 Claude 连接。

OPENAI_API_KEY 可选密钥 OpenAI 提供商的 API 密钥。

GOOGLE_API_KEY 可选密钥 Google 提供商（Gemini 模型）的 API 密钥。

其他可选配置项（8 个）

CRAFT_RPC_HOST 可选无头服务器绑定地址，默认 127.0.0.1，远程访问设为 0.0.0.0。

CRAFT_RPC_PORT 可选无头服务器绑定端口，默认 9100。

CRAFT_RPC_TLS_CERT 可选 PEM 证书文件路径，启用 wss:// 加密连接。

CRAFT_RPC_TLS_CA 可选可选的 PEM CA 链文件路径，用于客户端证书校验。

CRAFT_DEBUG 可选设为 true 时启用调试日志输出。

CRAFT_SERVER_URL 可选桌面端或 CLI 连接服务器用的 WebSocket 地址（ws:// 或 wss://）。

MICROSOFT_OAUTH_CLIENT_ID 可选 Microsoft OAuth 集成所需的客户端 ID，需在构建时通过 .env 文件写入。

SLACK_OAUTH_CLIENT_ID 可选 Slack OAuth 集成所需的客户端 ID。

macOS/Linux 一键安装：curl -fsSL https://agents.craft.do/install-app.sh | bash。Windows PowerShell：irm https://agents.craft.do/install-app.ps1 | iex。从源码构建：git clone https://github.com/lukilabs/craft-agents-oss.git && cd craft-agents-oss && bun install && bun run electron:start。

验证是否装好

安装后启动 Craft Agents 桌面应用，创建工作区并连接一个来源（如粘贴现有 MCP 配置 JSON），然后在会话中用 @ 提及该来源并提问，确认工具调用能正常返回结果。

常见排障

使用 --debug 标志启用详细日志记录
检查日志位置：macOS 上为 ~/Library/Logs/@craft-agent/electron/，Windows 上为 %APPDATA%\@craft-agent\electron\logs\main.log，Linux 上为 ~/.config/@craft-agent/electron/logs/main.log
确保 OAuth 客户端 ID 和密钥正确配置用于 Google 集成
验证 CRAFT_SERVER_TOKEN 在远程服务器模式下是否设置正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把 Linear 添加为一个来源并帮我读取我的待办事项
列出当前目录下有哪些文件
帮我从 Claude Code 导入我已有的 skills 和 MCP 配置
每天早上 9 点设置一个自动化任务，总结这个工作区本周完成的任务

使用场景

在统一界面中管理多个 AI 智能体会话

连接 MCP 服务器和 REST API（如 Gmail、Slack）作为来源

创建和导入技能以定制智能体行为

设置自动化以根据事件触发智能体会话

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Craft Agents 是 craft.do 开发的一个开源桌面应用，用于与 AI 智能体协作。它提供多会话收件箱、来源（MCP 服务器、REST API、本地文件）、技能、自动化以及权限控制。它基于 Claude Agent SDK 和 Pi SDK 构建，旨在提供一种更直观、非 CLI 的方式与强大的智能体交互。该应用支持远程无头服务器模式和命令行客户端。