Dataville

dataville-mcp

Dataville のデータソース API を MCP クライアント（Claude Desktop、Claude Code など）向けのツールとして公開する MCP サーバーです。

Dataville は、10 種類の公開データセット（Wikipedia、arXiv、Project Gutenberg、US Census、USDA FoodData、Papers with Code、 SEC EDGAR、OpenAlex、PyPI、Stack Exchange）を、1 つのインターフェースと 1 つの API キーで利用できる統合 REST API です。CSV／Parquet エクスポートと SQL クエリにも対応しています。このパッケージを使うと、MCP クライアントからツール呼び出しでこれらのソースを検索できます。

Dataville API キーが必要です。Dataville ダッシュボードから取得してください。

ドキュメント：docs.dataville.com · AI ツールを接続する · データソース。サンプル：dataville-wikimedia、dataville-sec-edgar、company-intelligence-agent。ライブデモ：app.dataville.com/demos。

ツール

ツール	説明
list_dataville_sources	各ソースと、そのソースでクエリ可能な SQL テーブル（ある場合）を一覧表示します。
describe_dataville_source	1 つのソースのキーワード形式、実行可能な例、テーブルの列を表示します：{ source }。
search_dataville	キーワードで 1 件を検索し、最適な一致を取得します：{ source, keywords, summary? }。
query_dataville	保存済みのテーブルに対して読み取り専用の SQL SELECT を実行し、一覧表示、フィルタリング、件数の取得、結合、LIMIT／OFFSET によるページ分割を行います：{ sql }。

4 つのツールはすべてデータの読み取りのみを行います。query_dataville は、検索のたびにライブで取得される census と news を除く、保存済みのすべてのソースに対応します。1 回の呼び出しで返される行数は最大 1,000 行で、返された行数に応じて課金されます。読み取るのは Dataville に保存されたコピーです。一部のソースは一括で読み込まれていますが、ほかのソースには以前に取得したレコードだけが保存されています。そのため、特定の項目を 1 つ検索する場合は search_dataville が確実です。

できること

接続後は、自然な言葉で質問すると、クライアントがソースを選択します：

• 「検索拡張生成に関する arXiv の論文を探して、要約してください。」
• 「Apple は最新の SEC 提出書類で何を報告しましたか？」
• 「US Census によると、テキサス州トラビス郡の世帯所得の中央値はいくらですか？」
• 「USDA FoodData によると、調理済みレンズ豆 100 g にはタンパク質がどれくらい含まれていますか？」
• 「PyPI で requests パッケージを調べてください。最新バージョンとライセンスは何ですか？」
• 「Jane Austen の Project Gutenberg の書籍を 10 冊、主題とあわせて一覧表示してください。」
• 「名前に 'lentils' を含む USDA FoodData の項目を 5 件、カテゴリとあわせて一覧表示してください。」

セットアップ

このパッケージはローカル（stdio）で動作する MCP サーバーです。クライアントは npx を使って、マシン上でサーバーを起動します。ローカルでの実行が不要な場合は、Dataville のホスト型エンドポイントに接続すれば、1 行で済み、インストールも不要です。

1 行でホスト型エンドポイントに接続（インストール不要）

Dataville は MCP を HTTP 経由でも直接提供しているため、クライアントはローカルで何も実行せずに接続できます。Node も設定ファイルも再起動も不要です。

claude mcp add --transport http dataville https://api.dataville.com/mcp

認証情報なしでも動作します（匿名利用の制限が適用されます）。通常の利用枠を使うには、--header "Authorization: Bearer dataville_your_key_here" を追加してください。Cursor と VS Code のユーザーは、このページ上部にあるインストールボタンを利用できます。その他のクライアントでも同じ URL を使えます。各アプリの Integrations ページに、クライアントごとの正確な設定スニペットが掲載されています。特定のバージョンに固定する場合やオフラインで作業する場合を除き、ホスト型エンドポイントを使用してください。このセクションの残りでは、ローカルでのセットアップについて説明します。

前提条件

• Node.js（LTS）がインストールされていること。npx の実行に必要です。インストールされていない場合、サーバーは起動に失敗します。node --version で確認してください。
• Dataville API キー。https://app.dataville.com/api-keys から取得してください。

設定ブロックはどの場所でも同じです。異なるのは、配置する場所だけです。

{
  "mcpServers": {
    "dataville": {
      "command": "npx",
      "args": ["-y", "@dataville/dataville-mcp"],
      "env": {
        "DATAVILLE_API_KEY": "dataville_your_key_here"
      }
    }
  }
}

インストール手順は不要です。npx が必要に応じてパッケージを取得して実行します。

Claude Desktop

1. Settings → Developer → Edit Config を開きます。claude_desktop_config.json が開きます。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. 上記のブロックを追加し（ファイルに mcpServers がすでにある場合は、その中に統合します）、実際の API キーを設定します。
3. Claude Desktop を完全に終了してから再起動します。ウィンドウを閉じるだけでなく、メニューバーまたはシステムトレイから終了してください。
4. dataville のツールがチャットボックスのツールアイコンの下に表示され、Settings → Developer に dataville が実行中と表示されます。

注：サーバーは Connectors ディレクトリではなく、ツールとして表示されます。このディレクトリにはリモート（ホスト型）コネクターのみが表示され、ローカルサーバーは見つかりません。「dataville から Apple の最新の売上高を取得して」のように自然に依頼すると、クライアントがツールを呼び出します。

Claude Code

claude mcp add dataville -e DATAVILLE_API_KEY=dataville_your_key_here -- npx -y @dataville/dataville-mcp

ツールを読み込むため、セッションを再起動してください。現在のプロジェクトだけでなく、すべてのプロジェクトで使えるようにするには、-s user を追加します。

設定

DATAVILLE_API_BASE_URL は任意で、デフォルト値は https://api.dataville.com です。開発中にローカルのバックエンドを指定する場合は、http://localhost:5000 に設定してください。

API キーの送信先

サーバーは環境変数から DATAVILLE_API_KEY を読み取り、DATAVILLE_API_BASE_URL に対してのみ Authorization: Bearer ヘッダーとして送信します。DATAVILLE_API_BASE_URL は、変更しない限り https://api.dataville.com です。API キーがログに記録されたり、ほかの場所に送信されたりすることはありません。ベース URL には https を使用する必要があります。プレーンな http が許可されるのは localhost、127.0.0.1、[::1] のみです。そのため、キーが暗号化されずにネットワーク上を送信されることはありません。

4 つのツールはすべて読み取り専用です。Dataville の検索と照会のみを行い、データの作成、変更、削除は行いません。

ソースから実行

git clone https://github.com/datavilleorg/dataville-mcp.git
cd dataville-mcp
npm install
npm run build

動作を確認する

クライアントに次のいずれかを尋ねてください。回答は意図的に検証可能なものにしてあります。ツールを使わず、記憶から回答したモデルも同じくらい自信ありげに答えるため、回答だけでは何も証明できません。

質問	何を確認すればよいか
Which data sources does Dataville have?	list_dataville_sources を呼び出し、11 個すべてを挙げます。
Using Dataville, what is the latest version of the requests package on PyPI?	pypi.org で確認できるバージョンです。バージョンは変動するため、記憶からは答えられません。
Using Dataville, get the latest SEC filing for AAPL and its revenue.	書類の種類、提出日、売上高の数値、そして開ける sec.gov へのリンクが示されます。
Using Dataville, how much protein is in 100g of uncooked quinoa?	USDA の正確な数値である、100 g あたり 14.1 g です。
Using Dataville SQL, list 5 Project Gutenberg books by Mark Twain.	query_dataville を呼び出し、gutenberg.org/ebooks/ で開ける Gutenberg ID と書名を返します。

クライアントでは、ツールが実行されたときに表示されます。表示されない場合は、プロンプトに「use dataville」と明記して、回答がソースと一致するか確認してください。

開発

npm run dev    # tsx watch
npm test       # node test runner
npm run build  # tsc

リリース

公開処理は CI から実行されます。npm では信頼された公開（OIDC）を使用するため、npm トークンは保存されません。MCP Registry のステップでは、リポジトリシークレットの MCP_PRIVATE_KEY を使ってログインします。リリースを行うには、バージョンを更新し、CHANGELOG.md を更新してから、新しいタグの GitHub Release を公開します。Publish ワークフローがビルド、テスト、npm への公開を行い、その後 MCP Registry に server.json を公開します（バージョンは package.json から設定されるため、手動で更新しないでください）。

レジストリ名 com.dataville/dataville-mcp は、dataville.com の apex にある DNS TXT レコード（v=MCPv1; k=ed25519; p=<public key>）によって承認されます。このレコードは、リポジトリシークレットの MCP_PRIVATE_KEY（hex）にある Ed25519 秘密鍵と照合されます。mcp-registry ジョブでログインに失敗した場合は、そのレコードとシークレットを確認してから、そのジョブだけを再実行してください。