omnidim-mcp-server

@omnidim-ai/mcp-server

适用于 OmniDimension 的本地标准输入输出 Model Context Protocol 服务。可通过 Claude、Cursor、Windsurf 或任何兼容 MCP 的客户端驱动语音 Agent、分派通话并管理知识库。

想使用托管版 OAuth 服务？请改用 https://mcp.omnidim.io/mcp。对于 Claude Desktop、Claude.ai 以及任何支持 HTTP MCP 的客户端，推荐使用托管服务。

快速开始

npx -y @omnidim-ai/mcp-server setup

如果 ~/.config/omnidim/credentials 中已保存 API 密钥，则会复用该密钥；否则会提示输入新密钥并进行验证。随后会在检测到的任意 MCP 客户端（Claude Code、Claude Desktop、Cursor、Windsurf）中安装服务。请前往 omnidim.io/api-management 获取 API 密钥。

手动安装

Claude Code

claude mcp add omnidim -- npx -y @omnidim-ai/mcp-server

Claude Desktop、Cursor、Windsurf

将此代码块添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "omnidim": {
      "command": "npx",
      "args": ["-y", "@omnidim-ai/mcp-server"],
      "env": {
        "OMNIDIM_API_KEY": "your_api_key_here"
      }
    }
  }
}

请从 omnidim.io/api-management 获取 API 密钥。

配置文件位置：

客户端	路径
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json

工具

类别	工具
Agent	创建、更新、列表、获取、删除
通话	分派、查看日志、获取日志
批量通话	创建、获取、查看、操作、取消、实时状态
知识库	列表、上传、关联、取消关联、删除
电话号码	列表、关联、取消关联、导入（Twilio、Exotel、SIP）
提供商	列出大模型、列出语音、列出 STT、列出 TTS
转售商	子组织、用户、额度（仅限转售商账户）

完整 API 参考：docs.omnidim.io。

本地开发

git clone https://github.com/Omnidim/omnidim-mcp-server
cd omnidim-mcp-server
npm install
npm run build
OMNIDIM_API_KEY=sk_... npm start

检查工具并进行交互式调用：

OMNIDIM_API_KEY=sk_... npx @modelcontextprotocol/inspector node build/index.js

遥测

我们会发送匿名使用数据，以帮助改进此软件包：软件包版本、Node 版本、操作系统系列、安装次数、会话启动次数、工具名称，以及以简短错误类别记录的设置或崩溃结果（例如 config_write_error、http_500）。不会收集 API 密钥、工具输入/输出、错误消息、文件路径或个人信息。

使用以下命令停用：

npx -y @omnidim-ai/mcp-server telemetry disable

完整的逐字段说明及其他退出选项请参阅 TELEMETRY.md。

故障排查

运行诊断命令，查看版本、检测到的客户端、后端连通性和近期错误：

npx -y @omnidim-ai/mcp-server doctor

该命令绝不会打印你的 API 密钥。错误日志会保存在本地 ~/.config/omnidim/logs/mcp.log 中（仅保留在你的设备上，绝不会发送）。

报告问题

请参阅 ISSUES.md，了解如何提交错误报告、请求功能或获取帮助。请将 doctor 的输出粘贴到报告中。

许可证

MIT