What is Marginalia Mcp Server

marginalia-mcp-server is an implementation of an MCP (Model Context Protocol) server designed for managing marginalia and annotations, providing access to the Marginalia Search engine focused on discovering non-commercial content on the internet.

Use cases

Use cases for marginalia-mcp-server include building applications that require web searches for non-commercial content, enhancing research tools with hidden gem discoveries, and integrating search capabilities into educational platforms.

How to use

To use marginalia-mcp-server, install it via npm with ‘npm install’ and build it using ‘npm run build’. Configure it using environment variables, especially the optional ‘MARGINALIA_API_KEY’ for enhanced access. You can perform searches using the MCP tool by specifying the required parameters like ‘query’, and optional parameters like ‘index’ and ‘count’.

Key features

Key features of marginalia-mcp-server include the ability to search the web using the Marginalia Search API, configurable search parameters, rate limiting protection with informative error messages, and seamless integration through the MCP SDK.

Where to use

marginalia-mcp-server can be used in various fields such as web development, research, content curation, and any application requiring access to non-commercial web content and annotations.

Marginalia MCP Server

An MCP (Model Context Protocol) server that provides access to Marginalia Search, a search engine focused on finding non-commercial content and hidden gems of the internet.

Features

• Search the web using Marginalia Search API
• Configurable search parameters including index and result count
• Rate limiting protection with helpful error messages
• Built using the MCP SDK for seamless integration

Installation

npm install
npm run build

Configuration

The server can be configured using environment variables:

• MARGINALIA_API_KEY: Your Marginalia Search API key (optional, defaults to public access)

To request a dedicated API key, contact: [email protected]

Usage

The server provides the following MCP tool:

search

Search the web using Marginalia Search with the following parameters:

• query (required): Search query string
• index (optional): Search index number (corresponds to dropdown in main GUI)
• count (optional): Number of results to return (1-100, default: 10)

Example usage through MCP:

const result = await mcp.useTool("marginalia", "search", {
  query: "interesting non-commercial websites",
  count: 5
});

Response Format

The search results are returned in the following format:

Error Handling

The server includes robust error handling for:

• Rate limiting (503 responses)
• Invalid requests
• Network errors
• API-specific errors

Adding Text-to-Speech Support

To enable text-to-speech capabilities using the say MCP server, add the following configuration:

For Cline (VSCode Extension)

Add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": [
        "/Users/barton/worlds/servers/src/say-mcp-server/build/index.js"
      ]
    }
  }
}

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": [
        "/Users/barton/worlds/servers/src/say-mcp-server/build/index.js"
      ]
    }
  }
}

The say MCP server provides text-to-speech capabilities with multiple voices and languages. Available tools:

• speak: Read text aloud using specified voice and rate
• list_voices: List all available text-to-speech voices

License

MIT License - See LICENSE file for details