Combell MCP

Combell MCP

这个Laravel 12应用程序公开了一个与Combell托管服务通信的模型上下文协议（MCP）服务器。它建立在 Combell PHP SDK 因此，编辑器和AI代理可以使用Combell资源，而无需直接处理凭据。

\[！警告\] 该项目正在积极开发中。将来，您将不需要在本地克隆和运行此存储库来使用Combell MCP服务器。

需求

• PHP 8.3 pcntl 和 pdo_mysql 已启用扩展
• 作曲家2.6或更新版本
• Node.js 20+，带npm或yarn
• MySQL 8（或其他兼容的数据库）用于本地开发

设置

1. 安装依赖项：

   composer install
   npm install

1. 复制 .env.example 到 .env，然后配置数据库访问和Combell凭据：

   COMBELL_API_KEY=your-key
   COMBELL_API_SECRET=your-secret

1. 生成应用程序密钥并运行数据库迁移：

   php artisan key:generate
   php artisan migrate

1. 安装Passport密钥和默认客户端（MCP OAuth需要）：

   php artisan passport:install --uuids

1. 当您需要UI资产时，请使用以下命令编译它们：

   npm run dev

光标中的MCP访问

1. 为应用程序提供服务，以便MCP客户端（游标、MCP检查器等）可以到达MCP端点：

   php artisan serve --host=127.0.0.1 --port=8000

1. 在您的MCP客户端（游标或MCP检查器）中，添加一个带有URL的新HTTP服务器 http://127.0.0.1:8000/mcp.
2. 服务器根据MCP规范通告OAuth（PKCE）：

- 授权元数据： http://127.0.0.1:8000/.well-known/oauth-authorization-server - 资源元数据： http://127.0.0.1:8000/.well-known/oauth-protected-resource

1. 所需的OAuth范围为 mcp:use.
2. 工具调用仍然需要您的Combell API令牌和机密。将它们作为标题提供：

- X-API-Key：您的Combell API代币 - X-API-Secret：您的Combell API秘密 MCP检查器支持自定义标头；Cursor将重用您为服务器配置的标头。

1. 授权后，客户端可以在Laravel应用程序运行时调用Combell MCP服务器。

开发工作流程

• 跑 php artisan test 执行Pest测试套件。
• 跑 vendor/bin/pint --dirty 在承诺修复样式问题之前。
• 开始 php artisan queue:work 如果您需要在本地处理排队的作业。