MOI MCP 快速使用指南¶

什么是 MOI MCP？¶

MOI MCP（MatrixOne Intelligence Model Context Protocol）是 MatrixOne Intelligence 提供的智能服务接口，让 AI 助手可以直接使用 MOI 平台的各种数据处理和分析功能。

MOI MCP 主要功能：

创建连接器 - 连接各种数据源
载入数据 - 从不同数据源导入和处理数据
创建工作流 - 构建自动化的数据处理流程
获取解析后的数据 - 获取经过 MOI 处理和分析的结构化数据

可用工具¶

MOI MCP 提供了丰富的工具来满足不同的数据处理需求。以下是所有可用工具的详细说明：

术语说明：本文中的“目录/库/卷”均为数据中心下的资源层级概念，并非传统意义上的数据库概念。

📁 目录管理工具¶

CreateCatalog - 创建新目录
GetCatalogInfo - 获取目录详情
GetCatalogList - 获取目录列表
GetCatalogTree - 获取完整目录树结构
DeleteCatalog - 删除目录

🗄️ 库管理工具¶

CreateDatabase - 在指定目录下创建库
GetDatabaseInfo - 获取库详细信息
GetDatabaseList - 获取指定目录下的库列表
GetDatabaseChildren - 获取库的子资源列表
DeleteDatabase - 删除库

📦 卷管理工具¶

CreateVolume - 在指定库下创建卷
GetVolumeInfo - 获取卷详细信息
DeleteVolume - 删除卷

📄 文件管理工具¶

GetFileList - 列出卷内的文件条目
DownloadFile - 下载文件

🔌 连接器管理工具¶

CreateConnector - 创建新的数据源连接器（OSS、S3 等）
ListConnectors - 获取现有连接器列表
UpdateConnector - 更新连接器配置
ListConnectorFiles - 列出连接器中的文件

📋 任务管理工具¶

CreateLoadTask - 创建数据加载任务
ListLoadTasks - 获取所有数据加载任务列表

🔄 工作流管理工具¶

GetWorkflowMeta - 获取工作流详情
CreateWorkflowMeta - 创建工作流
ListWorkflowMetas - 获取工作流列表
CreateWorkflowBranch - 创建工作流分支
ListWorkflowBranches - 获取工作流分支列表
GetWorkflowBranch - 获取工作流分支详情
UpdateWorkflowBranch - 更新工作流分支
DeleteWorkflowBranch - 删除工作流分支
EnableWorkflowBranch - 启用工作流分支
DisableWorkflowBranch - 禁用工作流分支

💡 使用提示：这些工具可以通过自然语言调用，AI 助手会自动选择合适的工具来完成您的请求。

1. MCP 配置¶

进入您的 MCP 客户端（Cursor、Claude 等）设置，找到配置 MCP 服务器的地方（不同客户端位置可能不同）
注册新的 MCP 服务器，在 mcpServers 下添加 “moi” 配置块，配置内容如下：

{
  "mcpServers": {
    "mcp-moi-server": {
      "type": "streamable-http",
      "url": "https://mcp.moi.matrixorigin.cn/mcp/",
      "note": "For Streamable HTTP connections, add this URL directly in your MCP Client",
      "headers": {
        "moi-key": "<your-api-key>"
      }
    }
  }
}

保存配置文件后，退出客户端并重新进入，使配置生效

2. 获取 API Key¶

访问 MatrixOne Intelligence 控制台
进入 API 管理页面
创建新的 API Key
复制密钥并更新配置文件中的 <your-api-key>
重启 AI 客户端

💡 详细说明：关于 API Key 的创建和管理，请参考 API Key 管理文档

开始使用¶

完成上述两个步骤后，就可以在对话中使用 MOI MCP 功能了：