内容
ly 服务器
[](./LICENSE)
[](https://github.com/KNIHAL/causly-server/actions/workflows/ci.yml)
[](./CONTRIBUTING.md)
一个自定义的 MCP（模型上下文协议）服务器，赋予 Claude 对本地机器和核心开发栈的完全、直接控制权，包括文件系统、Git、Shell、GitHub、Vercel 和 Supabase，所有这些都来自一个您完全拥有的独立服务器。
为 [Causly](#) 构建，作为其 AI 代理工作流的核心开发自动化层，并开源供其他构建者/创始人运行自己的实例。
## 为什么存在
Claude 在编写代码方面表现出色，但默认情况下，它无法触及您的文件、运行命令或与您实际部署的服务通信。大多数解决方案为每个服务添加一个单独的托管连接器，这增加了延迟、额外的跳转和混淆。Causly Server 采取相反的方法：**一个服务器，一个进程，完全控制**，完全在您自己的机器上运行。每个工具调用都会在本地记录，每个凭证都存放在您自己的 `.env` 文件中，没有任何内容通过第三方路由。
## 功能
**文件操作**
`read_file` · `read_multiple_files` · `create_file` · `write_file` · `edit_file` · `delete_file` · `move_file` · `copy_file` · `get_file_info`
**目录操作**
`list_directory` · `directory · `create_directory` · `delete_directory` · `search**Git 操作**
`git_init` · `git_status`git_add` · `git_commit` · `git_push`git_pull` · `git · `git_diff` · `git_branch`
**Shell 执行**
`run_command` — 在中运行任何 Shell 命令（npm 安装、测试、构建等）。小部分破坏性模式（磁盘擦除、`format`、`shutdown`）；其他所有操作都以完全权限运行，因为这是为受信任的单用户本地使用而设计的。
**GitHub**
`github_get_authenticated_user` · `github_create_repo` · `github_delete_repo` · `github_list_repos` · `github_create_issue` · `github_list_issues` · `github_create_pull_request` ·_requests` · `github_add_comment`
**Verc`vercel_get_authenticated_user` · `vercel_list_projects `vercel_get_project`vercel_list_deploy · `vercel_get_deployment` · `vercel_create` · `vercel_delete**Supabase**
`_list_organizations` · `supabase_list_projects` · `_get_project` · `supabase_create_project` · `supabase_delete_project` · `supabase_run_sql`
**日志记录**
调用 — 成功或失败 — 都被追加到 `logs/activity 以进行审计。
## 此工作流的实现
```mermaid
flowchart TD
A["💬 您在 Claude 中描述一个任务"] --> B["📝 Claude 编辑/创建文件\n, edit_file, write_file)"]
B --> C["🖥️ Claude 运行命令\n(run_command: install, build, test)"]
C --> D["🔀 Claude 提交并推送\n(git_add, git_commit, git_push)"]
D --> E["🐙 Claude 管理 GitHub\n(issues, PRs, repos)"]
--> F[" Claude 管理(create tables, run SQL)"]
E --> G[" 触发 Vercel 部署\n(vercel_create_deployment)"]
F --> G
G --> H["✅ 实时应用、数据库和仓库 —\n所有操作都源自一次对话"]
```
简而言之：您说话，Claude 编写、测试、提交、配置数据库、开启 PR 并部署 — 所有操作都通过一个本地服务器需您离开对话。
## 要求
- Node.js 18+
- Claude Desktop
## 设置
1. 在您的机器上克隆此仓库，例如 `D:\causly-server. 安装依赖项：
```bash
npm install
```
3. 运行设置向 它会询问每个令牌（跳过您不需要的令牌），并自动写入您的 `.env` 文件 **和** 更新 Desktop 配置：
```bash
npm run setup
更喜欢手动操作？env.example` 到 `. 并填写您需要的令牌，然后将 `mcpServers目添加到您的 Claude Desktop 配置中 上为 `%AP%\Claude\claude_desktop_config.json`）json
{
"mcpServers": {
ly-server": {
"command": "node",
": ["D:\\causly-server\\index.js }
}
}
```
4. 重启 Claude Desktopaude 现在将直接访问上述所有工具。
## 已知- **`supabase_run_sql`** 使用 Supabase 的管理 API，默认情况下限制直接 SQL 执行的个人访问令牌（` privileges`）。解决方法通过 Postgres 连接（使用项目的数据库密码）或使用项目的 PostgREST API — 尚未在此实现，跟踪为未来的改进。
- **Vercel 预览部署** 通过 `vercel_create_deployment` 创建的部署可能根据您的帐户设置，由 Vercel 的部署保护（SSO 墙）提供服务，而不是直接由您的应用程序提供。生产部署/自定义域不受影响。
- **`npm install` 在某些具有本 脚本的包上** 可能会在 Windows 上出现 `'node' is not recognized` 错误。这是因为 npm 始终通过 `cmd.exe` 运行生命周期脚本（`postinstall` 等），无论哪个 Shell 调用 npm，而该嵌套 `cmd.exe` 进程在 Claude Desktop 的生成环境中不总是继承一个有效的 `node` 路径。解决方法：运行 `npm install --ignore-scripts`，然后在需要时手动运行特定包的 postinstall 脚本，或在正常的终端中运行 `npm install` 以获取该依赖项，而不是通过 `run_command`。跟踪为一个开放问题。
## 安全注意事项
此服务器在安装它的机器上运行，具有**完全、无限制的访问权限** — 没有路径限制，API 令牌使用您授予的范围。这是一个有意的设计适用于个人/受信任的单用户设置，而不是通用部署将其暴露给其他用户或在共享环境中运行，请添加路径允许列表和更严格的权限范围，然后再执行此操作。
## 项目结构
usly-server/
├── index.js # 服务器入口点，工具注册
├── setup.js 交互式设置向npm run setup）
├── package.json
├── .env # 您的本地令牌（从不提交）
├── .env.example # 可以配置的令牌模板
├── CONTRIBUTING.md
├── CHANGELOG.md
├── .github/
│ ├── workflows/ci.yml # 推送/PR 上的语法检查 + 启动检查
│ ├── ISSUE_TEMPLATE/
│ └── PULL_REQUEST_TEMPLATE.md
├── tools/
│ ├── fileOps.js # 文件读写/编辑/移动/复制
│ ├── directoryOps.js # 目录列表、树、搜索
│ ├── gitOps.js # 通过 simple-git 进行 Git 操作
│ ├── commandOps.js # Shell 命令执行
│ ├── githubOps.js # GitHub REST API
│ ├── vercelOps.js # Vercel REST API
│ ├── supabaseOps.js # Supabase 管理 API
│ ├── envLoader.js # 无依赖 .env 解析器
│ └── logger.js # 活动日志记录
└── logs/
└── activity.log # 自动生成
```
## 路线图
计划中的新增功能，遵循相同的模式：Slack、Gmail、Figma。
##
参见 [CONTRIBUTING.md](./CONTRIBUTING.md) 了解如何添加新的工具模块和手动测试检查清单。
## 更新日志
参见 [CHANGELOG.md](./CHANGELOG.md) 了解发布历史。
## 许可证
MIT — 参见 [LICENSE](./LICENSE) 了解详情。
