@jsondb-cloud/mcp 1.0.17 → 1.0.25

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SIA Billy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -82,11 +82,14 @@ Add to `.cursor/mcp.json`:
 
 ### Environment Variables
 
-| Variable          | Required | Default                    | Description                                      |
-| ----------------- | -------- | -------------------------- | ------------------------------------------------ |
-| `JSONDB_API_KEY`  | Yes      | —                          | API key (`jdb_sk_live_...` or `jdb_sk_test_...`) |
-| `JSONDB_PROJECT`  | No       | `v1`                       | Project namespace                                |
-| `JSONDB_BASE_URL` | No       | `https://api.jsondb.cloud` | API base URL                                     |
+| Variable               | Required | Default                    | Description                                         |
+| ---------------------- | -------- | -------------------------- | --------------------------------------------------- |
+| `JSONDB_API_KEY`       | Yes      | —                          | API key (`jdb_sk_live_...` or `jdb_sk_test_...`)    |
+| `JSONDB_PROJECT`       | No       | `v1`                       | Project namespace                                   |
+| `JSONDB_BASE_URL`      | No       | `https://api.jsondb.cloud` | API base URL                                        |
+| `JSONDB_MCP_TRANSPORT` | No       | `stdio`                    | Transport type: `stdio` or `http`                   |
+| `JSONDB_MCP_PORT`      | No       | `3100`                     | HTTP server port (only used with `http` transport)  |
+| `JSONDB_MCP_HOST`      | No       | `127.0.0.1`                | HTTP bind address (only used with `http` transport) |
 
 ## Tools
 
@@ -141,6 +144,34 @@ Add to `.cursor/mcp.json`:
 | `delete_webhook` | Delete a webhook                                |
 | `test_webhook`   | Send a test event to verify delivery            |
 
+### Vectors
+
+| Tool                   | Description                                                                       |
+| ---------------------- | --------------------------------------------------------------------------------- |
+| `semantic_search`      | Search documents using natural language semantic similarity with relevance scores |
+| `store_with_embedding` | Store a document and auto-generate a vector embedding for semantic search         |
+
+Embeddings are generated **asynchronously by the jsondb.cloud backend** using **Ollama** (`nomic-embed-text`, 768 dimensions). The MCP server delegates to the REST API — no local embedding model or API key is needed.
+
+## HTTP Transport
+
+By default the server uses **stdio** transport (for Claude Desktop, Cursor, etc.). To run as an HTTP server instead, set:
+
+```bash
+JSONDB_MCP_TRANSPORT=http JSONDB_API_KEY=jdb_sk_live_... npx @jsondb-cloud/mcp
+```
+
+This starts a stateless Streamable HTTP server that creates a fresh `McpServer` + transport per request (no session affinity required). Endpoints:
+
+| Method   | Path      | Description                              |
+| -------- | --------- | ---------------------------------------- |
+| `POST`   | `/mcp`    | MCP JSON-RPC requests                    |
+| `GET`    | `/mcp`    | SSE stream for server notifications      |
+| `DELETE` | `/mcp`    | Session termination                      |
+| `GET`    | `/health` | Health check (returns `{"status":"ok"}`) |
+
+Configure the host and port with `JSONDB_MCP_HOST` and `JSONDB_MCP_PORT` (defaults: `127.0.0.1:3100`).
+
 ## Documentation
 
 Full documentation at [jsondb.cloud/docs](https://jsondb.cloud/docs).

package/dist/index.js

@@ -1493,17 +1493,17 @@ async function main() {
     project,
     baseUrl
   });
-  const server = new import_mcp2.McpServer({
-    name: "jsondb-cloud",
-    version: "1.0.0"
-  });
-  registerDocumentTools(server, db);
-  registerCollectionTools(server, db);
-  registerSchemaTools(server, db);
-  registerVersionTools(server, db);
-  registerWebhookTools(server, db);
-  registerVectorTools(server, db);
-  registerCollectionResources(server, db);
+  function createServer() {
+    const s = new import_mcp2.McpServer({ name: "jsondb-cloud", version: "1.0.0" });
+    registerDocumentTools(s, db);
+    registerCollectionTools(s, db);
+    registerSchemaTools(s, db);
+    registerVersionTools(s, db);
+    registerWebhookTools(s, db);
+    registerVectorTools(s, db);
+    registerCollectionResources(s, db);
+    return s;
+  }
   const transportType = process.env.JSONDB_MCP_TRANSPORT || "stdio";
   if (transportType === "http") {
     const port = parseInt(process.env.JSONDB_MCP_PORT || "3100", 10);
@@ -1514,25 +1514,16 @@ async function main() {
         res.end(JSON.stringify({ status: "ok" }));
         return;
       }
-      if (req.method === "POST" && req.url === "/mcp") {
-        const transport = new import_streamableHttp.StreamableHTTPServerTransport({
-          sessionIdGenerator: void 0
-        });
-        await server.connect(transport);
-        await transport.handleRequest(req, res);
-        return;
-      }
-      if (req.method === "GET" && req.url === "/mcp") {
+      if (req.url === "/mcp") {
+        const server = createServer();
         const transport = new import_streamableHttp.StreamableHTTPServerTransport({
           sessionIdGenerator: void 0
         });
-        await server.connect(transport);
-        await transport.handleRequest(req, res);
-        return;
-      }
-      if (req.method === "DELETE" && req.url === "/mcp") {
-        const transport = new import_streamableHttp.StreamableHTTPServerTransport({
-          sessionIdGenerator: void 0
+        res.on("close", () => {
+          transport.close().catch(() => {
+          });
+          server.close().catch(() => {
+          });
         });
         await server.connect(transport);
         await transport.handleRequest(req, res);
@@ -1545,6 +1536,7 @@ async function main() {
       console.error(`MCP HTTP server listening on ${host}:${port}`);
     });
   } else {
+    const server = createServer();
     const transport = new import_stdio.StdioServerTransport();
     await server.connect(transport);
   }

package/dist/index.mjs

@@ -1469,17 +1469,17 @@ async function main() {
     project,
     baseUrl
   });
-  const server = new McpServer2({
-    name: "jsondb-cloud",
-    version: "1.0.0"
-  });
-  registerDocumentTools(server, db);
-  registerCollectionTools(server, db);
-  registerSchemaTools(server, db);
-  registerVersionTools(server, db);
-  registerWebhookTools(server, db);
-  registerVectorTools(server, db);
-  registerCollectionResources(server, db);
+  function createServer() {
+    const s = new McpServer2({ name: "jsondb-cloud", version: "1.0.0" });
+    registerDocumentTools(s, db);
+    registerCollectionTools(s, db);
+    registerSchemaTools(s, db);
+    registerVersionTools(s, db);
+    registerWebhookTools(s, db);
+    registerVectorTools(s, db);
+    registerCollectionResources(s, db);
+    return s;
+  }
   const transportType = process.env.JSONDB_MCP_TRANSPORT || "stdio";
   if (transportType === "http") {
     const port = parseInt(process.env.JSONDB_MCP_PORT || "3100", 10);
@@ -1490,25 +1490,16 @@ async function main() {
         res.end(JSON.stringify({ status: "ok" }));
         return;
       }
-      if (req.method === "POST" && req.url === "/mcp") {
-        const transport = new StreamableHTTPServerTransport({
-          sessionIdGenerator: void 0
-        });
-        await server.connect(transport);
-        await transport.handleRequest(req, res);
-        return;
-      }
-      if (req.method === "GET" && req.url === "/mcp") {
+      if (req.url === "/mcp") {
+        const server = createServer();
         const transport = new StreamableHTTPServerTransport({
           sessionIdGenerator: void 0
         });
-        await server.connect(transport);
-        await transport.handleRequest(req, res);
-        return;
-      }
-      if (req.method === "DELETE" && req.url === "/mcp") {
-        const transport = new StreamableHTTPServerTransport({
-          sessionIdGenerator: void 0
+        res.on("close", () => {
+          transport.close().catch(() => {
+          });
+          server.close().catch(() => {
+          });
         });
         await server.connect(transport);
         await transport.handleRequest(req, res);
@@ -1521,6 +1512,7 @@ async function main() {
       console.error(`MCP HTTP server listening on ${host}:${port}`);
     });
   } else {
+    const server = createServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsondb-cloud/mcp",
-  "version": "1.0.17",
+  "version": "1.0.25",
   "description": "MCP (Model Context Protocol) server for jsondb.cloud — lets AI agents interact with your JSON database",
   "license": "MIT",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@jsondb-cloud/client": "*",
+    "@jsondb-cloud/client": "^1.0.18",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.0"
   },