Skip to main content
Glama
jeswr
by jeswr

solid-mcp

GitHub license npm version build Dependabot semantic-release

⚠️ WARNING: This entire project was created by generative AI and has not been reviewed or tested by a human yet. Use with caution in production environments.

Anthropic Model Context Protocol (MCP) integration for the Solid protocol.

This library enables AI models like Claude to access and manipulate data stored in Solid pods through the Model Context Protocol. It allows AI systems to read, write, search, and manage resources in Solid pods while respecting user privacy and control over their data.

Features

  • πŸ”„ Seamless integration between Anthropic's MCP and Solid pods

  • πŸ“ Read and write resources in Solid pods

  • πŸ” Search for resources and contents

  • πŸ“‚ Create and manage containers

  • πŸ” Authentication support for secure pod access

  • 🧰 Tool-based API for integration with AI models

  • πŸ“Š Structured data handling

Related MCP server: KnowledgeMCP

Installation

npm install @jeswr/solid-mcp

Usage

Basic Setup

import { createSolidMCPServer, SolidPodConfig } from '@jeswr/solid-mcp';

// Configure access to a Solid Pod
const config: SolidPodConfig = {
  podUrl: 'https://example.solidcommunity.net/',
  auth: {
    type: 'bearer',
    token: 'your-solid-access-token',
  }
};

// Create the MCP server
const server = createSolidMCPServer(config);

Reading a Resource

// Example MCP request to read a resource
const request = {
  action: 'read_resource',
  parameters: {
    uri: '/profile/card',
    include_content: true,
  },
};

// Handle the request
const response = await server.handleRequest(request);
console.log('Response:', response);

Writing a Resource

// Example MCP request to write a resource
const request = {
  action: 'write_resource',
  parameters: {
    uri: '/examples/hello.txt',
    content: 'Hello, Solid World!',
    content_type: 'text/plain',
  },
};

// Handle the request
const response = await server.handleRequest(request);
console.log('Response:', response);

Listing Container Contents

// Example MCP request to list a container
const request = {
  action: 'list_container',
  parameters: {
    uri: '/examples/',
  },
};

// Handle the request
const response = await server.handleRequest(request);
console.log('Response:', response);

Searching for Resources

// Example MCP request to search for resources
const request = {
  action: 'search',
  parameters: {
    container_uri: '/',
    search_term: 'profile',
    recursive: true,
  },
};

// Handle the request
const response = await server.handleRequest(request);
console.log('Response:', response);

API Reference

createSolidMCPServer(config: SolidPodConfig): SolidMCPServer

Creates a new MCP server for a Solid Pod.

SolidClient

Client for interacting with a Solid Pod.

  • readResource(uri: string, includeContent?: boolean): Promise<SolidResourceResponse>

  • writeResource(uri: string, content: any, contentType: string): Promise<SolidResourceResponse>

  • deleteResource(uri: string): Promise<boolean>

  • createContainer(uri: string): Promise<SolidResourceResponse>

SolidMCPServer

MCP server for Solid Pod integration.

  • handleRequest(request: any): Promise<any>

  • getService(): SolidMCPService

Integration with Anthropic Claude

This library makes it easy to integrate Solid pods with Anthropic's Claude AI through the Model Context Protocol. Claude can access and manipulate data in Solid pods while respecting user privacy and control.

Example Claude Integration

// In your Claude MCP client implementation
const solidMCPServer = createSolidMCPServer({
  podUrl: 'https://example.solidcommunity.net/',
  auth: { type: 'bearer', token: 'your-solid-access-token' }
});

// When Claude needs to access data
const claudeRequest = {
  action: 'read_resource',
  parameters: { uri: '/notes/important.txt' }
};

const response = await solidMCPServer.handleRequest(claudeRequest);
// Provide the response to Claude for context

Running Examples

The library includes example code showing how to use the various features:

npm run example

License

Β©2025–present Jesse Wright, MIT License.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jeswr/solid-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server