@comunica/mcp-sparql-solid 1.0.0

package/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright © 2026-now Ruben Taelman
+Ghent University – imec, Belgium
+
+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

@@ -0,0 +1,211 @@
+# Comunica MCP SPARQL Solid
+
+[![npm version](https://badge.fury.io/js/%40comunica%2Fmcp-sparql-solid.svg)](https://www.npmjs.com/package/@comunica/mcp-sparql-solid)
+
+Comunica MCP SPARQL Solid is an [MCP server](https://modelcontextprotocol.io/) for allowing AI agents to execute SPARQL queries over [Solid](https://solidproject.org/) data pods with authentication support.
+
+Solid (Social Linked Data) is a specification for decentralized data storage and personal data management. This MCP server enables authenticated access to private Solid pods.
+
+It's main distinguishing features are the following:
+
+* Improves the accuracy of your AI agent's answers by leveraging the power of SPARQL and Knowledge Graphs.
+* Execute [SPARQL 1.2](https://www.w3.org/TR/sparql12-query/) queries over Solid data pods.
+* Interactive authentication with Solid identity providers.
+* Access both public and private Solid resources.
+* Query over federated Solid pods with single sign-on.
+
+**[Learn more about Comunica on our website](https://comunica.dev/).**
+
+_Internally, this is a [Comunica module](https://comunica.dev/) that is configured with modules to execute SPARQL queries over Solid pods through MCP._
+
+## Supported by
+
+Comunica is a community-driven project, sustained by the [Comunica Association](https://comunica.dev/association/).
+If you are using Comunica, [becoming a sponsor or member](https://opencollective.com/comunica-association) is a way to make Comunica sustainable in the long-term.
+
+Our top sponsors are shown below!
+
+<a href="https://opencollective.com/comunica-association/sponsor/0/website" target="_blank"><img src="https://opencollective.com/comunica-association/sponsor/0/avatar.svg"></a>
+<a href="https://opencollective.com/comunica-association/sponsor/1/website" target="_blank"><img src="https://opencollective.com/comunica-association/sponsor/1/avatar.svg"></a>
+<a href="https://opencollective.com/comunica-association/sponsor/2/website" target="_blank"><img src="https://opencollective.com/comunica-association/sponsor/2/avatar.svg"></a>
+<a href="https://opencollective.com/comunica-association/sponsor/3/website" target="_blank"><img src="https://opencollective.com/comunica-association/sponsor/3/avatar.svg"></a>
+
+## Usage examples
+
+After connecting this MCP server to your AI agent (see some examples on how to do this below),
+your agent can SPARQL query Solid data pods, including private resources.
+
+For example, use it to ask:
+
+> Use Comunica SPARQL Solid to query my personal Solid pod and find all my contacts.
+
+### Prompt suggestions
+
+If you want your agent to always use SPARQL for higher accuracy in answers, you can tell it the following:
+
+> When looking up data from Solid pods, always prefer using SPARQL queries as this is more precise.
+> Solid pods may contain private data that requires authentication, so make sure to use the authenticated query engine.
+> Since SPARQL queries can take a while to execute, start producing an approximate answer yourself and show it to me if the SPARQL query takes more than 1 second, but then make the answer more concrete based on the SPARQL query once it finalized, as it will be more accurate.
+
+## Installation
+
+Comunica requires [Node.JS](http://nodejs.org/) 14.0 or higher and is tested on OSX and Linux.
+
+The easiest way to install the client is by installing it from NPM as follows:
+
+```bash
+$ [sudo] npm install -g @comunica/mcp-sparql-solid
+```
+
+Alternatively, you can install from the latest GitHub sources.
+For this, please refer to the README of the [Comunica monorepo](https://github.com/comunica/comunica).
+If you do so, the following examples require replacing `comunica-mcp-sparql-solid` with `node engines/mcp-sparql-solid/bin/mcp.js`.
+
+## Important: HTTP Mode Only
+
+**Note:** Due to the interactive nature of Solid authentication, this MCP server only supports HTTP mode. Stdio mode is not available as it cannot handle the interactive login flow required for Solid authentication.
+
+## Connect this MCP server to your agent
+
+Below, a non-exhaustive list of examples is given to connect this MCP server to your agent.
+
+### Claude Desktop
+
+After installing, you need to run the MCP server in HTTP mode:
+
+#### HTTP Mode with Authentication
+
+First, start the server manually:
+
+```bash
+$ comunica-mcp-sparql-solid --mode http --port 3123
+```
+
+This will prompt you to authenticate with your Solid identity provider. Follow the interactive login instructions in your terminal.
+
+Then, add the following entry to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "comunica-sparql-solid": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-remote",
+        "http://localhost:3123/mcp",
+        "--allow-http"
+      ]
+    }
+  }
+}
+```
+
+Then, you can ask Claude something like the following:
+
+> Using Comunica SPARQL Solid, can you show me information about myself based on my profile?
+
+#### Custom Identity Provider
+
+You can specify a custom Solid identity provider using the `--idp` flag:
+
+```bash
+$ comunica-mcp-sparql-solid --mode http --port 3123 --idp https://login.inrupt.com/
+```
+
+#### Disable Authentication
+
+If you only need to query public Solid resources, you can disable authentication:
+
+```bash
+$ comunica-mcp-sparql-solid --mode http --port 3123 --idp void
+```
+
+#### Default Sources
+
+You can optionally configure default Solid pod URLs when starting the MCP server:
+
+```bash
+$ comunica-mcp-sparql-solid --mode http --port 3123 https://example.solidcommunity.net/profile/card
+```
+
+### Claude Code
+
+#### HTTP Mode
+
+Run the MCP server in HTTP mode, which requires starting the server manually first:
+
+```bash
+$ comunica-mcp-sparql-solid --mode http --port 3123
+```
+
+Then add it to Claude Code:
+
+```bash
+claude mcp add --transport http sparql-solid http://localhost:3123/mcp
+```
+
+Learn more in the [Claude Code MCP docs](https://code.claude.com/docs/en/mcp).
+
+### ChatGPT
+
+At the time of writing, ChatGPT only supports HTTP-based MCP servers.
+So you'll need to run this tool under HTTP mode and expose it to the public Web,
+possibly combined with a reverse proxy and/or OAuth layer.
+
+```bash
+$ comunica-mcp-sparql-solid --mode http --port 3123
+```
+
+## Available Tools
+
+This MCP server provides the following tools:
+
+### query_sparql
+
+Execute SPARQL queries over one or more Solid pods or SPARQL endpoints, which also includes update queries.
+
+**Parameters:**
+- `query` (required): SPARQL query string
+- `sources` (required, unless default sources are configured): List of Solid pod URLs or SPARQL endpoint URLs
+- `queryFormatLanguage` (optional): Query language (e.g., `sparql`, `graphql`). Allows you to specify alternative query languages supported by Comunica
+- `queryFormatVersion` (optional): Query language version (e.g., `1.0`, `1.1`, `1.2`). Specifies the version of the query language to use
+- `baseIRI` (optional): Base IRI for resolving relative IRIs in the query
+- `httpProxy` (optional): HTTP proxy URL (e.g., `http://proxy.example.com:8080`)
+- `httpAuth` (optional): HTTP basic authentication in the format `username:password`
+- `httpTimeout` (optional): HTTP request timeout in milliseconds
+- `httpRetryCount` (optional): Number of HTTP request retries on failure
+
+**Note:** When the MCP server is started with default sources, the `sources` parameter is not available, and all queries automatically use the configured default sources.
+
+### query_sparql_rdf
+
+Execute SPARQL queries over a serialized RDF dataset provided as a string (useful for querying Turtle, N-Triples, or other RDF formats directly).
+
+**Parameters:**
+- `query` (required): SPARQL query string
+- `value` (required): Serialized RDF dataset as a string
+- `mediaType` (required): Media type of the serialized RDF dataset (e.g., `text/turtle`, `application/n-triples`, `application/ld+json`)
+- `fileBaseIRI` (optional): Base IRI for resolving relative IRIs in the RDF dataset
+- `baseIRI` (optional): Base IRI for resolving relative IRIs in the query
+- `queryFormatLanguage` (optional): Query language (e.g., `sparql`, `graphql`). Allows you to specify alternative query languages supported by Comunica
+- `queryFormatVersion` (optional): Query language version (e.g., `1.0`, `1.1`, `1.2`). Specifies the version of the query language to use
+
+## Authentication Flow
+
+When you start the MCP server with authentication enabled (default), you will be prompted to:
+
+1. Visit a URL in your web browser
+2. Log in to your Solid identity provider
+3. Authorize the application
+4. The server will automatically receive the authentication token
+
+Once authenticated, all queries will be executed with your Solid credentials, allowing access to private resources.
+
+## Learn more
+
+This README just shows the tip of the iceberg!
+Learn more about Comunica's functionalities in the following guides:
+
+* _[*Full documentation*](https://comunica.dev/docs/)_
+* _[*Solid documentation*](https://solidproject.org/)_

package/bin/mcp.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/mcp.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const query_sparql_solid_1 = require("@comunica/query-sparql-solid");
+const BinHelpersSolid_1 = require("../lib/BinHelpersSolid");
+// eslint-disable-next-line ts/no-require-imports,ts/no-var-requires,import/extensions
+(0, BinHelpersSolid_1.runCliSolid)(new query_sparql_solid_1.QueryEngine(), require('../package.json').version);
+//# sourceMappingURL=mcp.js.map

package/bin/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["mcp.ts"],"names":[],"mappings":";;;AACA,qEAA2D;AAC3D,4DAAqD;AAErD,sFAAsF;AACtF,IAAA,6BAAW,EAAC,IAAI,gCAAW,EAAE,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { QueryEngine } from '@comunica/query-sparql-solid';\nimport { runCliSolid } from '../lib/BinHelpersSolid';\n\n// eslint-disable-next-line ts/no-require-imports,ts/no-var-requires,import/extensions\nrunCliSolid(new QueryEngine(), require('../package.json').version);\n"]}

package/lib/BinHelpersSolid.d.ts

@@ -0,0 +1,2 @@
+import type { QueryEngineBase } from '@comunica/actor-init-query';
+export declare function runCliSolid(queryEngine: QueryEngineBase, version: string): void;

package/lib/BinHelpersSolid.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCliSolid = runCliSolid;
+const utils_mcp_1 = require("@comunica/utils-mcp");
+const yargs_1 = require("yargs");
+const helpers_1 = require("yargs/helpers");
+// eslint-disable-next-line ts/no-require-imports,ts/no-var-requires
+const { interactiveLogin } = require('solid-node-interactive-auth');
+function runCliSolid(queryEngine, version) {
+    (async () => {
+        const argv = await (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+            .usage('Usage: $0 [options] [sources...]')
+            .option('mode', {
+            alias: 'm',
+            type: 'string',
+            choices: ['http'],
+            demandOption: true,
+            description: 'Transport mode for the MCP server (only http mode supported for Solid)',
+        })
+            .option('port', {
+            alias: 'p',
+            type: 'number',
+            default: 3123,
+            description: 'Port to run the MCP server on',
+        })
+            .option('idp', {
+            type: 'string',
+            description: 'Solid identity provider to authenticate with (set to \'void\' to disable auth)',
+            default: 'https://solidcommunity.net/',
+        })
+            .example([
+            ['$0 --mode http --port 3000', 'Start MCP server in HTTP mode on port 3000 with default IDP'],
+            ['$0 --mode http --idp https://solidcommunity.net/', 'Start with a specific identity provider'],
+            ['$0 --mode http --idp void', 'Start without authentication'],
+            ['$0 --mode http https://example.org/data/', 'Start with a default Solid pod URL'],
+        ])
+            .parse();
+        // Extract positional arguments as default sources
+        const defaultSources = argv._.length > 0 ? argv._.map(String) : undefined;
+        // Handle Solid authentication
+        let session;
+        if (argv.idp !== 'void') {
+            try {
+                process.stderr.write(`Authenticating with identity provider: ${argv.idp}\n`);
+                session = await interactiveLogin({
+                    oidcIssuer: argv.idp,
+                });
+                process.stderr.write('Authentication successful!\n');
+            }
+            catch (error) {
+                process.stderr.write(`Authentication error: ${error.message}\n`);
+                if (error.stack) {
+                    process.stderr.write(`${error.stack}\n`);
+                }
+                process.exit(1);
+            }
+        }
+        // Prepare custom context with Solid session if authenticated
+        const customContext = session ?
+            { '@comunica/actor-http-inrupt-solid-client-authn:session': session } :
+            undefined;
+        const server = new utils_mcp_1.SparqlMcpServer('http', argv.port, queryEngine, version, process.stderr, defaultSources, customContext, ` If you want to query the WebID or pod of the user, you can pass the URL ${session?.info.webId}.`);
+        // Handle graceful shutdown
+        const cleanup = async () => {
+            if (session) {
+                try {
+                    await session.logout();
+                    process.stderr.write('Logged out from Solid pod\n');
+                }
+                catch (error) {
+                    process.stderr.write(`Logout error: ${error.message}\n`);
+                }
+            }
+        };
+        process.on('SIGINT', () => {
+            cleanup().then(() => process.exit(0)).catch(() => process.exit(1));
+        });
+        process.on('SIGTERM', () => {
+            cleanup().then(() => process.exit(0)).catch(() => process.exit(1));
+        });
+        await server.start().catch((error) => {
+            process.stderr.write(`Server error: ${error.message}\n`);
+            if (error.stack) {
+                process.stderr.write(`${error.stack}\n`);
+            }
+            return cleanup().finally(() => process.exit(1));
+        });
+    })().catch((error) => {
+        process.stderr.write(`Initialization error: ${error.message}\n`);
+        if (error.stack) {
+            process.stderr.write(`${error.stack}\n`);
+        }
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=BinHelpersSolid.js.map

package/lib/BinHelpersSolid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinHelpersSolid.js","sourceRoot":"","sources":["BinHelpersSolid.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable unicorn/no-process-exit */\nimport type { QueryEngineBase } from '@comunica/actor-init-query';\nimport { SparqlMcpServer } from '@comunica/utils-mcp';\nimport type { Session } from '@rubensworks/solid-client-authn-isomorphic';\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\n// eslint-disable-next-line ts/no-require-imports,ts/no-var-requires\nconst { interactiveLogin } = require('solid-node-interactive-auth');\n\nexport function runCliSolid(queryEngine: QueryEngineBase, version: string): void {\n  (async() => {\n    const argv = await yargs(hideBin(process.argv))\n      .usage('Usage: $0 [options] [sources...]')\n      .option('mode', {\n        alias: 'm',\n        type: 'string',\n        choices: [ 'http' ],\n        demandOption: true,\n        description: 'Transport mode for the MCP server (only http mode supported for Solid)',\n      })\n      .option('port', {\n        alias: 'p',\n        type: 'number',\n        default: 3123,\n        description: 'Port to run the MCP server on',\n      })\n      .option('idp', {\n        type: 'string',\n        description: 'Solid identity provider to authenticate with (set to \\'void\\' to disable auth)',\n        default: 'https://solidcommunity.net/',\n      })\n      .example([\n        [ '$0 --mode http --port 3000', 'Start MCP server in HTTP mode on port 3000 with default IDP' ],\n        [ '$0 --mode http --idp https://solidcommunity.net/', 'Start with a specific identity provider' ],\n        [ '$0 --mode http --idp void', 'Start without authentication' ],\n        [ '$0 --mode http https://example.org/data/', 'Start with a default Solid pod URL' ],\n      ])\n      .parse();\n\n    // Extract positional arguments as default sources\n    const defaultSources: string[] | undefined = argv._.length > 0 ? argv._.map(String) : undefined;\n\n    // Handle Solid authentication\n    let session: Session | undefined;\n    if (argv.idp !== 'void') {\n      try {\n        process.stderr.write(`Authenticating with identity provider: ${argv.idp}\\n`);\n        session = await interactiveLogin({\n          oidcIssuer: argv.idp,\n        });\n        process.stderr.write('Authentication successful!\\n');\n      } catch (error: any) {\n        process.stderr.write(`Authentication error: ${error.message}\\n`);\n        if (error.stack) {\n          process.stderr.write(`${error.stack}\\n`);\n        }\n        process.exit(1);\n      }\n    }\n\n    // Prepare custom context with Solid session if authenticated\n    const customContext = session ?\n        { '@comunica/actor-http-inrupt-solid-client-authn:session': session } :\n      undefined;\n\n    const server = new SparqlMcpServer(\n      'http',\n      argv.port,\n      queryEngine,\n      version,\n      process.stderr,\n      defaultSources,\n      customContext,\n      ` If you want to query the WebID or pod of the user, you can pass the URL ${session?.info.webId}.`,\n    );\n\n    // Handle graceful shutdown\n    const cleanup = async(): Promise<void> => {\n      if (session) {\n        try {\n          await session.logout();\n          process.stderr.write('Logged out from Solid pod\\n');\n        } catch (error: any) {\n          process.stderr.write(`Logout error: ${error.message}\\n`);\n        }\n      }\n    };\n\n    process.on('SIGINT', () => {\n      cleanup().then(() => process.exit(0)).catch(() => process.exit(1));\n    });\n\n    process.on('SIGTERM', () => {\n      cleanup().then(() => process.exit(0)).catch(() => process.exit(1));\n    });\n\n    await server.start().catch((error) => {\n      process.stderr.write(`Server error: ${error.message}\\n`);\n      if (error.stack) {\n        process.stderr.write(`${error.stack}\\n`);\n      }\n      return cleanup().finally(() => process.exit(1));\n    });\n  })().catch((error) => {\n    process.stderr.write(`Initialization error: ${error.message}\\n`);\n    if (error.stack) {\n      process.stderr.write(`${error.stack}\\n`);\n    }\n    process.exit(1);\n  });\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1 @@
+export * from './BinHelpersSolid';

package/lib/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BinHelpersSolid"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC","sourcesContent":["export * from './BinHelpersSolid';\n"]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@comunica/mcp-sparql-solid",
+  "version": "1.0.0",
+  "description": "An MCP server for executing SPARQL queries over Solid data pods with authentication support",
+  "license": "MIT",
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/comunica-association"
+  },
+  "homepage": "https://comunica.dev/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/comunica/comunica-feature-mcp.git",
+    "directory": "engines/mcp-sparql-solid"
+  },
+  "bugs": {
+    "url": "https://github.com/comunica/comunica-feature-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "agentic",
+    "comunica",
+    "sparql",
+    "solid",
+    "authentication",
+    "engine",
+    "query",
+    "update",
+    "sparql engine",
+    "sparql query",
+    "sparql update",
+    "sparql 1.1",
+    "sparql 1.2"
+  ],
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "typings": "lib/index",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "comunica-mcp-sparql-solid": "bin/mcp.js"
+  },
+  "files": [
+    "bin/**/*.d.ts",
+    "bin/**/*.js",
+    "bin/**/*.js.map",
+    "lib/**/*.d.ts",
+    "lib/**/*.js",
+    "lib/**/*.js.map"
+  ],
+  "scripts": {
+    "build": "yarn run build:ts",
+    "build:ts": "node \"../../node_modules/typescript/bin/tsc\""
+  },
+  "dependencies": {
+    "@comunica/query-sparql-solid": "^5.0.1",
+    "@comunica/utils-mcp": "^1.0.0",
+    "@rubensworks/solid-client-authn-isomorphic": "^2.0.0",
+    "@types/yargs": "^17.0.0",
+    "solid-node-interactive-auth": "^1.0.2",
+    "yargs": "^17.7.2"
+  },
+  "gitHead": "8a35a73d61cf1066bb1181761884d84d3b932932"
+}