Oomol Connect MCP Server

Oomol Connect MCP SDK

中文文档

用于Oomol Connect的MCP（模型上下文协议）SDK，可与Cherry Studio、VSCode和其他MCP兼容客户端集成。

特性

• ✅ 基于官方的完全MCP协议支持 @modelcontextprotocol/sdk
• ✅ 涵盖Oomo Connect所有功能的9个工具
• ✅ 完全支持TypeScript类型
• ✅ 文件上传支持（本地路径和base64编码）
• ✅ 具有指数回退的智能轮询
• ✅ 实时进度监控
• ✅ 智能版本筛选（默认返回最新版本）
• ✅ 与Cherry Studio、VSCode、Claude Desktop轻松集成

安装

全球安装

npm install -g oomol-connect-mcp-sdk-ts

使用npx（推荐）

npx -y oomol-connect-mcp-sdk-ts

地方发展

git clone 
cd oomol-connect-mcp-sdk-ts
npm install
npm run build

配置

环境变量

配置示例

# Required
export OOMOL_CONNECT_BASE_URL="http://localhost:3000/api"
export OOMOL_CONNECT_API_TOKEN="api-your-token-here"

# Optional
export OOMOL_CONNECT_DEFAULT_TIMEOUT="300000"

MCP客户端集成

樱桃工作室

添加到Cherry Studio的MCP配置中：

{
  "mcpServers": {
    "oomol-connect": {
      "command": "npx",
      "args": ["-y", "oomol-connect-mcp-sdk-ts"],
      "env": {
        "OOMOL_CONNECT_BASE_URL": "http://localhost:3000/api",
        "OOMOL_CONNECT_API_TOKEN": "your-token-here"
      }
    }
  }
}

克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "oomol-connect": {
      "command": "npx",
      "args": ["-y", "oomol-connect-mcp-sdk-ts"],
      "env": {
        "OOMOL_CONNECT_BASE_URL": "http://localhost:3000/api",
        "OOMOL_CONNECT_API_TOKEN": "your-token-here"
      }
    }
  }
}

VSCode

在VSCode设置中配置或使用MCP扩展。

可用工具

高级工具（推荐）

1. list_blocks -列出所有可用块（默认情况下返回最新版本，可选所有版本）
2. list_tasks -列出任务历史记录
3. 执行任务 -执行任务并等待完成（最常见）
4. 执行任务与文件 -通过文件上传执行任务
5. list_packages -列出已安装的软件包
6. 安装包 -安装软件包并等待完成

低级工具（高级）

1. 创建任务 -无需等待即可创建任务（异步）
2. 获取任务 -查询任务状态
3. 停止任务 -停止运行任务

使用示例

列表块

{
  "tool": "list_blocks",
  "arguments": {
    "includeAllVersions": false
  }
}

每个区块自动包含 blockId （格式： "package::name")以及 version 领域。

执行任务

{
  "tool": "execute_task",
  "arguments": {
    "blockId": "audio-lab::text-to-audio",
    "inputValues": {
      "text": "Hello",
      "voice": "en-US-JennyNeural"
    },
    "pollIntervalMs": 2000,
    "timeoutMs": 300000
  }
}

使用文件执行任务

{
  "tool": "execute_task_with_files",
  "arguments": {
    "blockId": "ffmpeg::audio_video_separation",
    "inputValues": {
      "outputFormat": "mp3"
    },
    "files": [
      {
        "path": "/absolute/path/to/video.mp4"
      }
    ]
  }
}

安装软件包

{
  "tool": "install_package",
  "arguments": {
    "name": "package-name",
    "version": "1.0.0"
  }
}

程序化使用

import { OomolConnectMcpServer } from "oomol-connect-mcp-sdk-ts";

const server = new OomolConnectMcpServer({
  baseUrl: "http://localhost:3000/api",
  authHeader: "Bearer your-token",
  name: "my-server",
  version: "1.0.0",
});

await server.run();

发展

# Install dependencies
npm install

# Build
npm run build

# Development mode (watch)
npm run dev

# Run locally
npm start

建筑

此SDK基于以下内容构建：

• @modelcontextprotocol/sdk -官方MCP SDK
• oomol-connect-sdk -Oomol Connect API客户端

SDK提供了一个零逻辑重复包装 oomol-connect-sdk，通过MCP协议公开其功能。

许可证

麻省理工学院

贡献

欢迎投稿！请打开问题或提交拉取请求。

相关项目

• oomol连接sdk-ts -核心Oomol连接SDK
• 云计算mcp sdk ts -面向Oomol Cloud的MCP SDK

支持

对于问题和疑问：

• GitHub问题： 创建问题
• 文档：有关更多使用模式，请参阅示例文件夹