Verodat MCP 服务器

概述

一个用于 Verodat 的模型上下文协议 (MCP) 服务器实现，能够将 Verodat 的数据管理能力与像 Claude Desktop 这样的 AI 系统无缝集成。

功能

• 账户 & 工作区管理

  • 列出可访问的账户
  • 浏览账户中的工作区

• 数据集操作

  • 创建具有自定义模式和验证的数据集
  • 查询和过滤数据集
  • 检索数据集记录

• AI 集成

  • 获取用于 AI 处理的工作区上下文
  • 在数据集上执行 AI 驱动的查询

前提条件

• Node.js (v18 或更高版本)
• Git
• Claude Desktop (用于 Claude 集成)
• Verodat 账户和 AI API 密钥

快速开始

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Verodat MCP 服务器：

npx -y @smithery/cli install @Verodat/verodat-mcp-server --client claude

手动安装

1. 克隆存储库：

   git clone https://github.com/Verodat/verodat-mcp-server.git
   cd verodat-mcp-server
   

2. 安装依赖项并构建：

   npm install
   npm run build
   

3. 配置 Claude Desktop：

   创建或修改配置文件：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

   添加以下配置：

   {
       "mcpServers": {
           "verodat": {
               "command": "node",
               "args": ["path/to/verodat-mcp-server/build/src/index.js"],
               "env": {
                   "VERODAT_AI_API_KEY": "your-verodat-ai-api-key"
               }
           }
       }
   }
   

Verodat 入门

1. 在 verodat.com 注册一个 Verodat 账户
2. 从您的 Verodat 仪表板生成一个 AI API 密钥
3. 将 API 密钥添加到您的 Claude Desktop 配置

可用命令

服务器提供以下 MCP 命令：

// 账户 & 工作区管理
get-accounts        // 列出可访问的账户
get-workspaces     // 列出账户中的工作区
get-queries 		// 检索现有的 AI 查询

// 数据集操作
create-dataset     // 创建一个新的数据集
get-datasets      // 列出工作区中的数据集
get-dataset-output // 检索数据集记录
get-dataset-targetfields // 检索数据集目标字段
upload-dataset-rows  // 将新的数据行添加到现有数据集

// AI 操作
get-ai-context     // 获取工作区 AI 上下文
execute-ai-query   // 在数据集上运行 AI 查询

调试

MCP 服务器通过 stdio 进行通信，这可能会使调试具有挑战性。 我们提供了一个 MCP Inspector 工具来帮助：

npm run inspector

这将提供一个 URL 以访问浏览器中的调试工具。

贡献

我们欢迎贡献！ 请随时提交 Pull Request。

许可证

有关详细信息，请参阅 LICENSE 文件

支持

• 文档: Verodat 文档
• 问题: GitHub Issues
• 社区: Verodat 社区

---