使用说明
可命令MCP
可命令的MCP是您的代理需要的第一个也是最后一个MCP框架
它允许代理安全地构建、配置和服务MCP集成和轻量级应用程序后端*
一个MCP，任何应用程序
*静态加密的凭据，模型永远看不到它们
https://github.com/user-attachments/assets/ac66133c-162f-4959-81c9-664010d40b3b
Commandable为连接的代理提供了构建自己工具的工具。就像MCP盗梦空间！代理将与任何API的连接定义为JSON，要求用户通过web API安全地输入他们的凭据，然后他们离开，针对这些API创建新工具，甚至在同一个过程中使用它们，甚至不必直接访问您的凭据。
Commandable还为流行的应用程序提供了越来越多的开箱即用的预构建集成。对这个图书馆的贡献非常欢迎。
当你想：
- 快速连接GitHub、Notion、Google、Jira和Trello等现有应用程序
- 在这些工具中构建特定于您的数据的自定义工具
- 连接尚未安装MCP服务器的应用程序
- 让代理为特定工作流或用户编写自定义工具集
- 将凭据保存在服务器端，在静止时加密，并脱离模型上下文
快速入门：本地流
1.启动本地Commandable实例
npx -y @commandable/mcp serve
文件处理工具，如Google Drive read_file_content 在当地工作 npx 仅当Python 3和MarkItDown在主机上可用时安装。如果缺少这些工具，Commandable将继续运行，但与文件处理相关的工具将被隐藏。
使用以下命令安装本地提取器依赖关系：
pip3 install -r packages/core/src/file-extractor/requirements.txt
如果你不想在本地安装Python，可以使用Docker。发布的图像包括提取运行时。
2.连接克劳德代码创建模式
npx -y @commandable/mcp create
这会打印出确切的 claude mcp add ... 命令。该命令现在的目标是 @commandable/mcp-connect create-mode.
3） 开始构建
打开Claude Code，在创建会话中配置集成、工具集和自定义工具。
4） 连接兼容客户端
在您的创建会话配置了服务器后，为不支持动态工具加载的客户端打印一个静态模式代码段：
npx -y @commandable/mcp connect --client claude-desktop
对于光标：
npx -y @commandable/mcp connect --client cursor
这两个代码段都指向兼容客户端 @commandable/mcp-connect static-mode.
MCP模式
Commandable现在提供三个MCP表面：
/mcp-动态模式。启动精益并按需将工具集加载到会话中。/mcp/static-静态回退。Eager会提前加载所有已配置的工具。/mcp/create-动态模式加上构建器功能，用于添加集成和生成自定义工具。
当您的客户端支持MCP动态工具加载时，请使用动态模式。使用静态模式以实现兼容性或简单设置。当您希望代理配置Commandable本身时，请使用创建模式。
快速入门：HTTP流
当Commandable作为共享或远程服务运行时，请使用此选项。
1.运行app/server包
来自此repo：
yarn workspace @commandable/mcp dev
2.创建API密钥
DATABASE_URL="$DATABASE_URL" COMMANDABLE_ENCRYPTION_SECRET="$COMMANDABLE_ENCRYPTION_SECRET" npx -y @commandable/mcp create-api-key my-app
3.打印克劳德代码HTTP设置
npx -y @commandable/mcp create --transport http --url http://localhost:3000/mcp/create --api-key <your-api-key>
4.打印动态HTTP详细信息
npx -y @commandable/mcp connect --transport http --url http://localhost:3000/mcp --api-key <your-api-key>
5.可选：打印静态HTTP详细信息
对于回退客户端或简单的兼容性测试：
npx -y @commandable/mcp connect --transport http --url http://localhost:3000/mcp/static --api-key <your-api-key>
预构建集成
Commandable还附带了一套强大的预构建集成，可以开箱即用。这些不是整个产品，但它们为您提供了一个直接的基础：快速连接，开始构建，然后根据需要扩展或生成自定义MCP功能。下面的列表会定期增长。
| 集成 | 工具 | 工具集 | 实时测试 |
|---|---|---|---|
| 气垫桌 | 11 | 所有工具 | 气动试验 |
| 汇流 | 11 | 所有工具 | 汇流测试 |
| GitHub | 47 | code, issues, pull_requests, ci, releases, repo_admin |
GitHub测试 |
| Google 日历 | 17 | events, sharing |
谷歌日历测试 |
| Google 工作区 | 46 | drive, docs, sheets, slides |
谷歌工作区测试 |
| Gmail | 25 | email, organize |
Gmail测试 |
| 集客 | 31 | 所有工具 | HubSpot测试 |
| Jira | 23 | issues, boards |
Jira测试 |
| 概念 | 19 | pages, databases |
概念测试 |
| 特雷洛 | 34 | 所有工具 | Trello测试 |
安全
Commandable会立即加密凭据并将其存储在主目录中(~/.commandable/)除非你覆盖 COMMANDABLE_DATA_DIR.
在已部署的HTTP设置中，使用 commandable.config.yaml 和 ${ENV_VAR} 通过部署环境引用和注入机密。
CLI 参考
| 命令 | 它的作用 |
|---|---|
commandable-mcp serve [--restart] |
构建/运行本地可命令应用服务器和管理UI |
| `commandable-mcp create [--transport stdio | http] [--apply] [--url] [--api-key]` |
| `commandable-mcp connect [--client claude-desktop | cursor] [--transport stdio |
commandable-mcp doctor |
打印本地服务器和环境的诊断 |
commandable-mcp destroy local --yes [--keep-key] |
停止守护进程并擦除本地状态 |
commandable-mcp apply [--config <file>] |
将配置作为代码应用于当前环境 |
commandable-mcp create-api-key [name] |
为HTTP MCP终结点创建API密钥 |
commandable-mcp --help |
显示使用情况 |
commandable-mcp --version |
打印版本 |
贡献
看 [CONTRIBUTING.md](./CONTRIBUTING.md) 用于开发、测试和发布。
许可证
AGPL v3。看 许可证.
