Connectcloud MCP Server

🧠 CData Connect AI MCP 服务器

](https://nodejs.org/)  ](https://www.docker.com/)  ](https://smithery.ai/server/@CDataSoftware/connectcloud-mcp-server)

🚨 现在可在Connect AI中使用 🚨

Connect AI（原名Connect Cloud）现在内置了一个远程MCP服务器（使用Streamable HTTP传输类型）。 了解更多.

此项目仍然允许使用STDIO传输类型在本地安装/托管MCP服务器。

______________________________________________________________________

A. 模型上下文协议（MCP） 用于查询和管理数据的服务器 CData Connect AI这台服务器使人工智能代理能够使用SQL、元数据内省和过程执行来与数据进行交互。

______________________________________________________________________

✨ 特点

• ✅ 在云连接的数据源上执行SQL查询
• 🔄 执行批量操作（插入、更新、删除）
• ⚙️ 执行存储过程
• 📚 访问元数据（目录、模式、表、列）

______________________________________________________________________

🛠 先决条件

• 版本18或更高版本
• A. CData Connect Cloud（可译为“CData云端连接器”或根据具体语境简化为“CData云端服务”） 拥有API访问权限的账户
• A. 个人访问令牌 (PAT) 用于身份验证

______________________________________________________________________

⚙️ 设置

通过Smithery进行安装

通过自动方式为Claude Desktop安装CData Connect AI MCP服务器 “Smithery”可以翻译为“铁匠铺”或“锻造工坊”。这个词汇来源于对“smith”（铁匠）的扩展，指的是进行金属加工、锻造等活动的工作场所：

npx -y @smithery/cli install @CDataSoftware/connectcloud-mcp-server --client claude

手动安装

1. 克隆仓库

   git clone https://github.com/cdatasoftware/connectcloud-mcp-server.git
   cd connect-cloud-mcp-server

1. 安装依赖项

   npm install

1. 配置环境变量

创建一个 .env 包含以下内容的文件：

   CDATA_USERNAME=your_username
   CDATA_PAT=your_personal_access_token

   # Optional Configuration
   LOG_ENABLED=false
   LOG_LEVEL=info
   CDATA_URL=https://your-test-environment-url

   # Transport Configuration (default: http)
   TRANSPORT_TYPE=http  # or 'stdio' for terminal usage
   PORT=3000           # HTTP server port
   HOST=localhost      # HTTP server host

______________________________________________________________________

▶️ 运行服务器

开发模式

使用 ts-node 用于实时开发：

npm run dev

生产模式

构建并启动：

npm run build
npm start

HTTP传输端点

当使用HTTP传输（默认设置）运行时，服务器提供以下端点：

• MCP 端点： http://localhost:3000/mcp - 主模型上下文协议端点
• 直接终端（或 直接端点）: http://localhost:3000/direct - 直接JSON-RPC端点，无会话管理
• 宣言；表单（Manifest的常见中文翻译，具体根据上下文可能有所不同）： http://localhost:3000/.well-known/mc/manifest.json - MCP发现清单

使用STDIO传输

要改用 STDIO 传输方式（用于终端/CLI 使用）：

TRANSPORT_TYPE=stdio npm start

______________________________________________________________________

🔍 使用MCP Inspector进行测试

MCP Inspector 是一种可视化测试工具，它提供了网页用户界面（UI）和命令行界面（CLI）来测试 MCP 服务器。此项目完全支持该测试工具。

快速设置验证

运行安装验证脚本以确保所有配置均正确无误：

npm run validate:inspector

这将检查您的配置并提供详细的设置说明。

快速入门：使用Inspector

1. 全局安装检查器 （可选但建议）：

   npm install -g @modelcontextprotocol/inspector

1. 启动带有Web用户界面的检查器：

   npm run inspector

这会打开一个网页界面，您可以在其中选择并测试不同的传输配置。

测试不同的传输方式

STDIO 传输

# Launch inspector with STDIO transport (starts server automatically)
npm run inspector:stdio

HTTP传输

# Start the server first
npm run dev:http

# Then in another terminal, launch inspector
npm run inspector:http

命令行测试

# Quick CLI testing with STDIO transport
npm run inspector:cli

# Test specific methods directly
npm run test:inspector

检查器配置

该项目包括一个 mcp-inspector.json 包含预配置服务器设置的配置文件：

• connectcloud-stdio 翻译为中文是“云端连接-标准输入输出（或标准终端）”。不过，这里的“stdio”在计算机领域通常指的是“standard input and output”，即标准输入和输出，但在某些上下文中，尤其是在提到开发环境或工具时，它也可能泛指一个标准的终端或控制台界面。因此，根据具体语境，“connectcloud-stdio”可以灵活翻译为“云端连接的标准终端”或“云端连接的标准输入输出环境”STDIO传输方式，支持自动服务器启动
• connectcloud-http（可译为“云端连接-HTTP”或根据具体语境简化为“云连接HTTP”）可流式传输的HTTP传输（需手动启动服务器）

可用的检查器脚本

______________________________________________________________________

🧰 可用工具

🔹 数据操作

🔹 元数据操作

______________________________________________________________________

🤖 与大型语言模型（LLMs）的使用

此服务器兼容实现模型上下文协议的AI代理。

示例（TypeScript + MCP Agent）

const response = await agent.generateContent({
  tools: [
    {
      name: "queryData",
      parameters: {
        query: "SELECT * FROM Salesforce1.Salesforce.Account LIMIT 10"
      }
    }
  ]
});

______________________________________________________________________

🐳 在 Docker 中运行

构建镜像

docker build -t mcp/connectcloud:latest -f Dockerfile .

______________________________________________________________________

🧩 Claude 桌面集成

添加或编辑此配置到您的（系统/设置中） claude_desktop_config.json 在……之下 mcpServers 部分/章节：

🔹 来自 Docker

{
  "mcpServers": {
    "connect-cloud": {
      "command": "docker",
      "args": [
        "run", 
        "-i",
        "--rm",
        "--name", "connect-cloud-mcp",
        "-e", "CDATA_USERNAME",
        "-e", "CDATA_PAT",
        "mcp/connectcloud"
      ],
      "env": {
        "CDATA_USERNAME": "",
        "CDATA_PAT": ""
      }
    }
  }
}

通过Npx

{
  "mcpServers": {
    "connect-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@cdatasoftware/connectcloud-mcp-server"],
      "env": {
        "CDATA_USERNAME": "",
        "CDATA_PAT": ""
      }
    }
  }
}

______________________________________________________________________

📄 许可证

这个项目遵循以下许可协议： 麻省理工学院许可证（MIT License）。