Verodat Mcp サーバー

Verodat MCPサーバーとは？

Verodat MCPサーバーは、データの管理と処理のための堅牢でスケーラブルなサーバーソリューションを提供するために設計されたオープンソースプロジェクトです。特に、さまざまなデータタイプやワークフローを効率的に処理できる集中型データ管理システムを実装しようとする組織にとって便利です。このサーバーは、パフォーマンス、信頼性、および既存のシステムとの統合の容易さに重点を置いて構築されています。

Verodat MCPサーバーの特徴

• スケーラビリティ：サーバーは、パフォーマンスを損なうことなく、増加するデータやユーザーリクエストを処理できます。
• データ管理：データの保存、取得、処理のための包括的なツールを提供し、データ駆動型の意思決定に依存するビジネスに最適です。
• オープンソース：オープンソースプロジェクトであるため、開発者は特定のニーズに応じて機能をカスタマイズおよび拡張できます。
• ユーザーフレンドリーなインターフェース：サーバーには、データやサーバー設定の管理を簡素化する直感的なインターフェースが付属しています。
• コミュニティサポート：オープンソースエコシステムの一部として、ユーザーはコミュニティの貢献、ドキュメント、およびサポートを利用できます。

Verodat MCPサーバーの使用方法

1. インストール：公式リポジトリからサーバーをダウンロードします。ドキュメントに記載されたインストール手順に従って、サーバー環境にセットアップします。
2. 設定：インストール後、組織のニーズに合わせてサーバー設定を構成します。これには、ユーザー権限の設定、データ保存オプションの設定、他のシステムとの統合が含まれます。
3. データ管理：サーバーのインターフェースを使用して、データをアップロード、管理、処理します。データ処理タスクを自動化するワークフローを作成できます。
4. 監視とメンテナンス：サーバーのパフォーマンスを定期的に監視し、最適な運用を確保するためにメンテナンスを行います。トラブルシューティングや更新のためにコミュニティリソースを活用します。

よくある質問

Verodat MCPサーバーはどのプログラミング言語で構築されていますか？

Verodat MCPサーバーは、主に[ここにプログラミング言語を挿入]を使用して構築されており、パフォーマンスとスケーラビリティで知られています。

Verodat MCPサーバーの使用に費用はかかりますか？

いいえ、Verodat MCPサーバーはオープンソースであり、無料で使用できます。ただし、ホスティングやメンテナンスに関連する費用が発生する可能性があります。

Verodat MCPサーバープロジェクトに貢献できますか？

もちろんです！貢献は歓迎されます。問題を報告したり、コードを提出したり、プロジェクトのGitHubリポジトリを通じてドキュメントを改善することで参加できます。

Verodat MCPサーバーのサポートを受けるにはどうすればよいですか？

サポートはコミュニティフォーラム、GitHubの問題、ドキュメントを通じて利用できます。他のユーザーや開発者とつながって支援を受けることもできます。

Verodat MCPサーバーは小規模企業に適していますか？

はい、Verodat MCPサーバーはスケーラブルに設計されており、小規模企業と大企業の両方に適しています。その柔軟性により、さまざまなビジネスの規模やニーズに適応できます。

Verodat MCP Server

Overview

A Model Context Protocol (MCP) server implementation for Verodat, enabling seamless integration of Verodat's data management capabilities with AI systems like Claude Desktop.

Verodat MCP Server

This repository contains a Model Context Protocol (MCP) server implementation for Verodat, allowing AI models to interact with Verodat's data management capabilities through well-defined tools.

Overview

The Verodat MCP Server provides a standardized way for AI models to access and manipulate data in Verodat. It implements the Model Context Protocol specification, providing tools for data consumption, design, and management.

Tool Categories

The server is organized into three main tool categories, each offering a progressive set of capabilities:

1. Consume (8 tools)

The base category focused on data retrieval operations:

• get-accounts: Retrieve available accounts
• get-workspaces: List workspaces within an account
• get-datasets: List datasets in a workspace
• get-dataset-output: Retrieve actual data from a dataset
• get-dataset-targetfields: Retrieve field definitions for a dataset
• get-queries: Retrieve existing AI queries
• get-ai-context: Get workspace context and data structure
• execute-ai-query: Execute AI-powered queries on datasets

2. Design (9 tools)

Includes all tools from Consume, plus:

• create-dataset: Create a new dataset with defined schema

3. Manage (10 tools)

Includes all tools from Design, plus:

• upload-dataset-rows: Upload data rows to existing datasets

Prerequisites

• Node.js (v18 or higher)
• Git
• Claude Desktop (for Claude integration)
• Verodat account and AI API key

Installation

Quick Start

Installing via Smithery

To install Verodat MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

1. Clone the repository:

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

2. Install dependencies and build:

npm install
npm run build

3. Configure Claude Desktop: Create or modify the config file:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   Add the configuration which is mensioned below in configuration:

Getting Started with Verodat

1. Sign up for a Verodat account at verodat.com
2. Generate an AI API key from your Verodat dashboard
3. Add the API key to your Claude Desktop configuration

Configuration

The server requires configuration for authentication and API endpoints. Create a configuration file for your AI model to use:

{
  "mcpServers": {
    "verodat-consume": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/consume.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    }
  }
}

Configuration Options

You can configure any of the three tool categories by specifying the appropriate JS file one at a time in claude:

• Consume only: Use consume.js (8 tools for data retrieval)
• Design capabilities: Use design.js (9 tools, includes dataset creation)
• Full management: Use manage.js (10 tools, includes data upload)

Example for configuring all three categories simultaneously:

{
  "mcpServers": {
    "verodat-consume": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/consume.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    },
    "verodat-design": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/design.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    },
    "verodat-manage": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/manage.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    }
  }
}

Environment Variables

• VERODAT_AI_API_KEY: Your Verodat API key for authentication
• VERODAT_API_BASE_URL: The base URL for the Verodat API (defaults to "https://verodat.io/api/v3" if not specified)

Tool Usage Guide

Available Commands

The server provides the following MCP commands:

// Account & Workspace Management
get-accounts        // List accessible accounts
get-workspaces      // List workspaces in an account
get-queries         // Retrieve existing AI queries

// Dataset Operations
create-dataset      // Create a new dataset
get-datasets        // List datasets in a workspace
get-dataset-output  // Retrieve dataset records
get-dataset-targetfields // Retrieve dataset targetfields
upload-dataset-rows // Add new data rows to an existing dataset

// AI Operations
get-ai-context      // Get workspace AI context
execute-ai-query    // Run AI queries on datasets

Selecting the Right Tool Category

• For read-only operations: Use the consume.js server configuration
• For creating datasets: Use the design.js server configuration
• For uploading data: Use the manage.js server configuration

Security Considerations

• Authentication is required via API key
• Request validation ensures properly formatted data

Development

The codebase is written in TypeScript and organized into:

• Tool handlers: Implementation of each tool's functionality
• Transport layer: Handles communication with the AI model
• Validation: Ensures proper data formats using Zod schemas

Debugging

The MCP server communicates over stdio, which can make debugging challenging. We provide an MCP Inspector tool to help:

npm run inspector

This will provide a URL to access debugging tools in your browser.

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

License

LICENSE file for details

Support

• Documentation: Verodat Docs
• Issues: GitHub Issues
• Community: Verodat Community