🧠 CData Connect AI MCP 服务器
🚨 现在可在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手动安装
- 克隆仓库
git clone https://github.com/cdatasoftware/connectcloud-mcp-server.git
cd connect-cloud-mcp-server- 安装依赖项
npm install- 配置环境变量
创建一个 .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 startHTTP传输端点
当使用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
- 全局安装检查器 （可选但建议）：
npm install -g @modelcontextprotocol/inspector- 启动带有Web用户界面的检查器：
npm run inspector这会打开一个网页界面，您可以在其中选择并测试不同的传输配置。
测试不同的传输方式
STDIO 传输
# Launch inspector with STDIO transport (starts server automatically)
npm run inspector:stdioHTTP传输
# 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传输（需手动启动服务器）
可用的检查器脚本
| 脚本 | 描述 |
|---|---|
npm run inspector | 启动带有服务器选择功能的检查员Web用户界面 |
npm run inspector:stdio | 启动带有STDIO传输的检查器 |
npm run inspector:http | 启动使用HTTP传输的检查器 |
npm run inspector:cli | 带STDIO传输的CLI模式 |
npm run test:inspector | 快速自动化测试 |
______________________________________________________________________
🧰 可用工具
🔹 数据操作
| 工具 | 描述 |
|---|---|
queryData | 执行SQL查询 |
execData | 执行存储过程 |
🔹 元数据操作
| 工具 | 描述 |
|---|---|
getCatalogs | 获取可用目录 |
getSchemas | 列出目录中的模式 |
getTables | 列出模式中的表 |
getColumns | 获取表的列元数据 |
getPrimaryKeys | 获取表的主键 |
getIndexes | 获取表的索引信息 |
getImportedKeys | 获取引用其他表的外键列 |
getExportedKeys | 检索来自表的外键列引用 |
getProcedures | 列出可用的程序 |
getProcedureParameters | 获取过程输入/输出参数 |
______________________________________________________________________
🤖 与大型语言模型（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）。
