Xdp MCP Server

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）

📖 文档

• 医学博士：详细的开发指南和架构
• 测试.md：全面的测试和故障排除指南

🚨 故障排除

服务器无法启动

# 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集成

📞 支持

1. 检查 测试.md 解决方案
2. 查看服务器日志中的特定错误
3. 独立测试XDP API连接
4. 验证Claude Desktop配置格式

📄 许可证

MIT许可证-详见package.json。