项目简介

Cyoda MCP集成服务是一个基于Model Context Protocol (MCP)实现的后端服务，旨在将Cyoda平台强大的功能（如实体管理、高级搜索、边缘消息、工作流自动化和环境部署）以标准化的方式暴露给大型语言模型（LLM）客户端。通过JSON-RPC协议，LLM可以无缝调用这些功能，实现更智能、上下文感知的AI应用。

主要功能点

实体管理：LLM可以创建、读取、更新、删除和列出Cyoda平台上的结构化数据实体。
高级搜索：支持LLM进行复杂的字段查询、全文搜索和条件组合，以查找特定实体。
边缘消息：允许LLM发送和检索通过Cyoda消息系统分发的消息。
工作流管理：提供导出、导入和复制工作流的能力，支持LLM自动化业务流程。
环境部署：使LLM能够调度和管理Cyoda平台上的AI环境和用户应用部署。

安装步骤

本服务推荐使用 'pipx' 进行安装和运行，确保在隔离环境中执行：

设置Cyoda认证信息：您需要从Cyoda平台获取 'CYODA_CLIENT_ID'、'CYODA_CLIENT_SECRET' 和 'CYODA_HOST'。请在您的聊天环境中提问 "Please deploy a Cyoda environment for me" 以获取这些凭证。在您的终端中设置环境变量：

export CYODA_CLIENT_ID="your-client-id"
export CYODA_CLIENT_SECRET="your-client-secret"
export CYODA_HOST="client-<id>.eu.cyoda.net" # 例如: client-123.eu.cyoda.net

零配置运行（无需克隆，无需虚拟环境）：

pipx run mcp-cyoda-client

一次安装，重复运行：

# 安装包
pipx install mcp-cyoda-client

# 运行服务器（默认使用stdio传输协议）
mcp-cyoda-client

# 或者使用自定义选项（例如HTTP传输协议和端口）
mcp-cyoda-client --transport http --port 9000
mcp-cyoda-client --help # 查看更多选项

服务器配置

本MCP服务器通过环境变量获取其运行所需的Cyoda平台凭证。在MCP客户端（如Cursor, Claude Desktop等）中配置本MCP服务器时，您需要提供如下JSON配置：

{
  "mcpServers": {
    "cyoda": {
      "command": "mcp-cyoda-client",
      "env": {
        "CYODA_CLIENT_ID": "在此处填写您的Cyoda客户端ID",
        "CYODA_CLIENT_SECRET": "在此处填写您的Cyoda客户端密钥",
        "CYODA_HOST": "在此处填写您的Cyoda环境主机地址 (例如: client-123.eu.cyoda.net)"
      }
    }
  }
}

'command'：指定MCP服务器的可执行命令，通常是 'mcp-cyoda-client'。
'env'：包含MCP服务器运行所需的环境变量，'CYODA_CLIENT_ID'、'CYODA_CLIENT_SECRET' 和 'CYODA_HOST' 是必填项，用于连接到Cyoda平台。

基本使用方法

一旦MCP服务器成功运行并连接到您的AI助手（MCP客户端），您就可以通过自然语言请求来利用Cyoda平台的功能。

示例对话：

数据收集与存储：
- 您: "去网站 'https://example.com' 抓取产品数据"
- AI: [从网站抓取数据]
- 您: "将这些数据作为实体保存到Cyoda"
- AI: [使用MCP工具在您的Cyoda环境中创建实体]
数据检索：
- 您: "搜索类别为 'electronics' 的实体"
- AI: [使用搜索工具查找匹配的实体]
- 您: "获取ID为 'abc-123' 的实体"
- AI: [使用实体管理工具检索特定实体]
工作流操作：
- 您: "从我的产品实体导出工作流"
- AI: [使用工作流管理工具导出工作流定义]
- 您: "将此工作流复制到我的订单实体"
- AI: [在实体之间复制工作流]

AI助手将无缝结合网络抓取、数据处理和Cyoda操作，使复杂的数据工作流通过自然语言请求变得简单。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息