Combell MCP服务器

Name: Combell MCP服务器
Author: Joehoel

一个基于Laravel的Model Context Protocol (MCP)服务器，用于与Combell托管服务通信，允许编辑器和AI代理无需直接处理凭据即可操作Combell资源。

在 GitHub 查看 Joehoel/combell-mcp

使用说明

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

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

安装依赖项：
```
composer install
npm install
```
复制 .env.example 到 .env，然后配置数据库访问和Combell凭据：
```
COMBELL_API_KEY=your-key
COMBELL_API_SECRET=your-secret
```
生成应用程序密钥并运行数据库迁移：
```
php artisan key:generate
php artisan migrate
```
安装Passport密钥和默认客户端（MCP OAuth需要）：
```
php artisan passport:install --uuids
```
当您需要UI资产时，请使用以下命令编译它们：
```
npm run dev
```

为应用程序提供服务，以便MCP客户端（游标、MCP检查器等）可以到达MCP端点：
```
php artisan serve --host=127.0.0.1 --port=8000
```
在您的MCP客户端（游标或MCP检查器）中，添加一个带有URL的新HTTP服务器 http://127.0.0.1:8000/mcp.
服务器根据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
所需的OAuth范围为 mcp:use.
工具调用仍然需要您的Combell API令牌和机密。将它们作为标题提供：
- X-API-Key：您的Combell API代币
- X-API-Secret：您的Combell API秘密 MCP检查器支持自定义标头；Cursor将重用您为服务器配置的标头。
授权后，客户端可以在Laravel应用程序运行时调用Combell MCP服务器。