远程MCP服务器模板\[早期版本\]
此项目提供了一个模板，用于构建 模型上下文协议（MCP）服务器 用于商业工具可组合商业。MCP服务器可以托管在 commercetools连接 并且被设计为易于配置和扩展，适用于各种商业用例。
概述
MCP服务器充当人工智能代理的服务通道，实现对商业工具API的安全、灵活和上下文感知的访问。它支持公共和私有身份验证模式，并允许对可用工具和操作进行细粒度控制。
特性
- 可配置的身份验证： 支持两者
client_credentials和auth_token身份验证。 - 基于工具的访问控制： 使用启用或限制API操作
TOOLS配置。 - 管理模式： 允许创建和编辑资源（可选）。
- 易于部署： 已准备好在commercetools Connect上托管。
配置
配置通过管理 connect.yaml 文件。以下是对每个字段的解释：
standardConfiguration
| 关键字 | 描述 | 默认值 | 必填 |
|---|---|---|---|
AUTH_TYPE | 使用 client_credentials 对于配置了API客户端的公共MCP，或 auth_token 用于承载令牌访问。 | client_credentials | 没有 |
AUTH_URL | commercetools可组合商务身份验证URL。 | 是 | |
API_URL | commercetools可组合商务API URL。 | 是 | |
TOOLS | 以逗号分隔的工具列表(请参阅文档).使用 all 对于所有工具。 | all | 是的 |
IS_ADMIN | 设置为 true 以允许创建和编辑资源。启用之前，请先查看您的用例。 | false | 没有 |
securedConfiguration
| 密钥 | 描述 | 必填 |
|---|---|---|
PROJECT_KEY | commercetools可组合商务项目关键。 | 是 |
CLIENT_ID | commercetools可组合商务客户端ID。 | 是 |
CLIENT_SECRET | commercetools可组合商务客户端机密。 | 是 |
认证
- 公共模式(
client_credentials):\
使用配置的API客户端凭据进行身份验证。
- 私人模式(
auth_token):\
需要一个 Authorization 每个请求中都有一个Bearer令牌的标头。
工具配置
这 TOOLS 字段控制哪些API操作可用。
- 使用逗号分隔的列表（例如。，
products.read,cart.create). - 使用
all启用所有可用工具。 - 请参阅 MCP基本文件 查看完整列表。
如何发展
- 克隆存储库：
git clone
cd composable-commerce-remote-mcp- 安装依赖项：
npm install- 配置您的环境：
- 编辑 connect.yaml 设置您的项目凭据和所需的配置。 - （可选）使用 .env 本地开发文件。
- 在本地运行MCP服务器：
npm run build
npm start- 部署以连接：
- 使用commercetools Connect文档打包您的服务并进行部署。
支持
如有疑问或问题，请联系 commercetools支持团队.