使用说明
XDP MCP服务器
一种模型上下文协议（MCP）服务器，为数据工程和分析任务提供与XDP（扩展数据平台）的无缝集成。
🚀 快速开始
1.克劳德桌面的设置
# Install dependencies and build
npm install
npm run build
# Auto-configure Claude Desktop
./setup-claude-desktop.sh
2.重新启动克劳德桌面
3.测试集成
打开克劳德桌面并尝试：
List all data stores from XDP
📋 特性
- 🔗 XDP API集成：使用访问/密钥直接连接到XDP平台
- 📊 数据存储列表：通过分页获取和浏览所有可用的数据存储
- 🔧 克劳德桌面就绪：已预先配置，可立即与Claude Desktop一起使用
- 🛡️ 稳健的错误处理：全面的错误处理和用户友好的消息
- 📝 详细日志记录：用于调试和监控的广泛日志记录
🏗️ 建筑
Claude Desktop ←→ XDP MCP Server ←→ XDP API
(stdio) (Node.js) (REST/HTTPS)
📁 项目结构
xdp-mcp-server/
├── README.md # This file
├── mcp.md # Detailed development guide
├── TESTING.md # Comprehensive testing guide
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── setup-claude-desktop.sh # Auto-setup script
├── claude_desktop_config.json # Example config
├── src/
│ ├── index.ts # Main MCP server
│ ├── services/
│ │ └── xdp-api-client.ts # XDP API integration
│ └── types/
│ └── xdp-types.ts # TypeScript definitions
└── dist/ # Compiled output
🛠️ 可用工具
xdp_list_datastores
从XDP平台列出支持分页的数据存储。
参数：
page（可选）：页码（从0开始，默认值：0）size（可选）：每页项目数（默认值：20，最大值：100）sortBy（可选）：排序字段和方向（默认值：“updatedAt:asc”）
示例用法：
Show me data stores on page 2 with 10 items, sorted by name
🔧 发展
构建和测试
# Install dependencies
npm install
# Build TypeScript
npm run build
# Test locally
export XDP_ACCESS_KEY="your-access-key"
export XDP_SECRET_KEY="your-secret-key"
npm run test
环境变量
XDP_ACCESS_KEY：XDP API访问密钥（必需）XDP_SECRET_KEY：XDP API密钥（必需）XDP_BASE_URL：API基本URL（可选，默认为demo.xdp.accldata.tech）
📖 文档
🚨 故障排除
服务器无法启动
# Check Node.js version (requires 18+)
node --version
# Rebuild project
npm run clean && npm run build
身份验证问题
- 验证访问/密钥是否正确
- 确保凭据中没有多余的空格
- 直接测试API连接
Claude桌面集成
- 验证配置文件路径：
~/Library/Application Support/Claude/claude_desktop_config.json - 确保配置中的绝对路径
- 完全重新启动克劳德桌面
看 测试.md 了解详细的故障排除。
🔮 未来的增强功能
- []Spark上下文和查询执行
- []Trino集群集成
- []数据管道管理
- []实时监控
- []Bolt.diy web集成
📞 支持
- 检查 测试.md 解决方案
- 查看服务器日志中的特定错误
- 独立测试XDP API连接
- 验证Claude Desktop配置格式
📄 许可证
MIT许可证-详见package.json。
