@dataville/dataville-mcp 0.1.5 → 0.1.6

package/README.md

@@ -1,5 +1,13 @@
 # dataville-mcp
 
+[![M8ven Score](https://m8ven.ai/badge/mcp/datavilleorg-dataville-mcp-u1eou7?v=6abe1c0b98731d0af6f8978f1b3778e6)](https://m8ven.ai/mcp/datavilleorg-dataville-mcp-u1eou7?s=readme)
+[![npm](https://img.shields.io/npm/v/@dataville/dataville-mcp)](https://www.npmjs.com/package/@dataville/dataville-mcp)
+[![CI](https://github.com/datavilleorg/dataville-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/datavilleorg/dataville-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=dataville&config=eyJ1cmwiOiJodHRwczovL2FwaS5kYXRhdmlsbGUuY29tL21jcCJ9)
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Dataville-0098FF?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=dataville&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.dataville.com%2Fmcp%22%7D)
+
 MCP server exposing Dataville's data source API as tools for MCP clients (Claude Desktop, Claude Code, etc.).
 
 [Dataville](https://dataville.com) is a unified REST API over ten public datasets —
@@ -15,6 +23,16 @@ Requires a Dataville API key — get one from the [Dataville dashboard](https://
 - `list_dataville_sources` — lists the data sources available via `search_dataville`.
 - `search_dataville` — query a data source: `{ source, keywords, params? }`.
 
+## What you can ask
+
+Once connected, ask in plain language and the client picks the source:
+
+- "Find an arXiv paper on retrieval-augmented generation and summarize it."
+- "What did Apple report in its latest SEC filing?"
+- "What's the median household income in Travis County, Texas, per the US Census?"
+- "How much protein is in 100 g of cooked lentils, according to USDA FoodData?"
+- "Look up the `requests` package on PyPI — what's the latest version and license?"
+
 ## Setup
 
 This package is a local (stdio) MCP server: the client launches it on your
@@ -32,6 +50,7 @@ claude mcp add --transport http dataville https://api.dataville.com/mcp
 
 That works with no credentials at all (anonymous limits). Add
 `--header "Authorization: Bearer dataville_your_key_here"` for the full quota.
+Cursor and VS Code users can use the install buttons at the top of this page.
 Other clients take the same URL; the app's Integrations page has the exact
 snippet for each. Use the hosted endpoint unless you specifically want to pin a
 version or work offline — the rest of this section covers that local setup.

package/dist/client.js

@@ -1,6 +1,6 @@
 const DEFAULT_BASE_URL = "https://api.dataville.com";
 // Keep in sync with package.json version (enforced by a test).
-export const VERSION = "0.1.5";
+export const VERSION = "0.1.6";
 const USER_AGENT = `dataville-mcp/${VERSION}`;
 export class DatavilleApiError extends Error {
     status;

package/dist/index.js

@@ -1,44 +1,9 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import { searchDataSource, VERSION } from "./client.js";
-import { DATAVILLE_SOURCES } from "./sources.js";
-const server = new McpServer({
-    name: "dataville-mcp-server",
-    version: VERSION,
-});
-server.registerTool("list_dataville_sources", {
-    title: "List Dataville data sources",
-    description: "List the data sources available through Dataville's search_dataville tool.",
-    inputSchema: {},
-}, async () => ({
-    content: [{ type: "text", text: JSON.stringify(DATAVILLE_SOURCES, null, 2) }],
-}));
-server.registerTool("search_dataville", {
-    title: "Search a Dataville data source",
-    description: "Query one of Dataville's data sources (see list_dataville_sources for valid source names) with a keyword string and optional query params.",
-    inputSchema: {
-        source: z.string().describe("Data source name, e.g. 'wikipedia', 'arxiv', 'edgar'"),
-        keywords: z.string().describe("Search keywords or identifier for the query"),
-        params: z
-            .record(z.union([z.string(), z.number(), z.boolean()]))
-            .optional()
-            .describe("Optional additional query parameters"),
-    },
-}, async ({ source, keywords, params }) => {
-    try {
-        const result = await searchDataSource(source, keywords, params);
-        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return { content: [{ type: "text", text: message }], isError: true };
-    }
-});
+import { createServer } from "./server.js";
 async function main() {
     const transport = new StdioServerTransport();
-    await server.connect(transport);
+    await createServer().connect(transport);
 }
 main().catch((error) => {
     console.error("Fatal error starting Dataville MCP server:", error);

package/dist/server.js

@@ -0,0 +1,53 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { searchDataSource, VERSION } from "./client.js";
+import { DATAVILLE_SOURCES } from "./sources.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "dataville-mcp-server",
+        version: VERSION,
+    });
+    server.registerTool("list_dataville_sources", {
+        title: "List Dataville data sources",
+        description: "List the data sources available through Dataville's search_dataville tool.",
+        inputSchema: {},
+        // Returns a static list bundled with the server; makes no network calls.
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => ({
+        content: [{ type: "text", text: JSON.stringify(DATAVILLE_SOURCES, null, 2) }],
+    }));
+    server.registerTool("search_dataville", {
+        title: "Search a Dataville data source",
+        description: "Query one of Dataville's data sources (see list_dataville_sources for valid source names) with a keyword string and optional query params.",
+        inputSchema: {
+            source: z.string().describe("Data source name, e.g. 'wikipedia', 'arxiv', 'edgar'"),
+            keywords: z.string().describe("Search keywords or identifier for the query"),
+            params: z
+                .record(z.union([z.string(), z.number(), z.boolean()]))
+                .optional()
+                .describe("Optional additional query parameters"),
+        },
+        // A GET against the Dataville API, which fronts external data sources.
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ source, keywords, params }) => {
+        try {
+            const result = await searchDataSource(source, keywords, params);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { content: [{ type: "text", text: message }], isError: true };
+        }
+    });
+    return server;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataville/dataville-mcp",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "mcpName": "com.dataville/dataville-mcp",
   "description": "MCP server exposing Dataville's data source API as tools for MCP clients",
   "private": false,