模型上下文协议服务器模板

远程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基本文件 查看完整列表。

如何发展

1. 克隆存储库：

   复制

   git clone <your-repo-url>
   cd composable-commerce-remote-mcp
   

2. 安装依赖项：

   复制

   npm install
   

3. 配置您的环境：

   • 编辑 connect.yaml 设置您的项目凭据和所需的配置。
   • （可选）使用 .env 本地开发文件。

4. 在本地运行MCP服务器：

   复制

   npm run build
   npm start
   

5. 部署以连接：

   • 使用commercetools Connect文档打包您的服务并进行部署。

支持

如有疑问或问题，请联系 commercetools支持团队.

参考文献

• commercetools连接文档
• MCP基本文件