🚀 Verodat MCP 层架构图

本项目提供了 Verodat MCP 层架构的相关信息，以及如何在模型上下文协议服务器中使用 Verodat 的详细指南，帮助用户将代码和数据插入 AI 系统。

架构图展示

🚀 快速开始

此文档指导如何在模型上下文协议服务器（用于将代码和数据插入 AI 系统，如 Claude Desktop）中使用 Verodat（https://verodat.io）。

✨ 主要特性

当前 Verodat MCP 服务器提供以下工具：

• 账户和工作区管理：
  • get-accounts - 列出你可以访问的所有账户
  • get-workspaces - 列出指定账户中的所有工作区
• 数据集操作：
  • create-dataset - 创建具有定义的架构和验证规则的新数据集
  • get-datasets - 从工作区检索数据集，带有过滤功能
  • get-dataset-output - 检索数据集中实际的数据记录
• AI 和上下文：
  • get-ai-context - 检索工作区上下文，包括数据集配置
  • execute-ai-query - 在数据集数据上执行 AI 驱动的查询

📦 安装指南

安装要求

1. Node.js：确保安装了 Node.js。你可以通过以下链接下载并安装：https://nodejs.org
2. Git：确保安装了 Git。你可以通过以下链接下载并安装：https://git-scm.com/downloads
3. Claude Desktop：
   • Mac：访问 https://claude.ai/download 下载 macOS 版本。
   • Windows：访问 https://claude.ai/download 下载 Windows 版本。

安装步骤

1. 打开终端或命令提示符，运行以下命令克隆 Verodat MCP 服务器仓库：

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

2. 导航到 path/to/verodat-mcp-server 目录，并运行以下命令安装依赖项并构建项目：

npm install
npm run build

💻 使用示例

在 Claude Desktop 中配置 Verodat MCP 服务器

要与 Claude Desktop 一起使用，请按照以下步骤进行配置：

MacOS

编辑 ~/Library/Application Support/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>>"
            }
        }
    }
}

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

你可以在这里注册一个 Verodat 账户：https://verodat.com

获取 AI API 密钥

登录到你的 Verodat 账户，生成你的 AI API 密钥，并将其替换在以下配置文件中：

"VERODAT_AI_API_KEY": "<<your-verodat-ai-api-key>>"

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们推荐使用 MCP 检查器，它作为包脚本可用：

npm run inspector

检查器将在浏览器中提供一个访问调试工具的 URL。