Marginalia MCP Server

by bmorphism
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

マージナリアMCPサーバー

非営利コンテンツやインターネット上の隠れた宝石を見つけることに特化した検索エンジン、 Marginalia Searchへのアクセスを提供する MCP (Model Context Protocol) サーバー。

特徴

  • Marginalia Search API を使用してウェブを検索する
  • インデックスや結果数などの設定可能な検索パラメータ
  • 役立つエラーメッセージによるレート制限保護
  • シームレスな統合のためにMCP SDKを使用して構築

インストール

npm install npm run build

構成

サーバーは環境変数を使用して設定できます。

  • MARGINALIA_API_KEY : Marginalia Search API キー (オプション、デフォルトはパブリックアクセス)

専用APIキーをリクエストするには、 kontakt@ marginalia.nuまでご連絡ください。

使用法

サーバーは次の MCP ツールを提供します。

検索

次のパラメータを使用して、Marginalia Search を使用して Web を検索します。

  • query (必須): 検索クエリ文字列
  • index (オプション):検索インデックス番号(メインGUIのドロップダウンに対応)
  • count (オプション): 返される結果の数 (1-100、デフォルト: 10)

MCP 経由の使用例:

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

応答フォーマット

検索結果は次の形式で返されます。

{ "query": "your search query", "license": "license information", "results": [ { "url": "result url", "title": "page title", "description": "page description" } // ... more results ] }

エラー処理

サーバーには、次の堅牢なエラー処理機能が含まれています。

  • レート制限(503件の応答)
  • 無効なリクエスト
  • ネットワークエラー
  • API固有のエラー

テキスト読み上げサポートの追加

say MCP サーバーを使用してテキスト読み上げ機能を有効にするには、次の構成を追加します。

Cline(VSCode拡張機能)の場合

~/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"] } } }

クロードデスクトップ向け

~/Library/Application Support/Claude/claude_desktop_config.jsonに追加します:

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

say MCPサーバーは、複数の音声と言語に対応したテキスト読み上げ機能を提供します。利用可能なツール:

  • speak : 指定された音声と速度でテキストを読み上げる
  • list_voices : 利用可能なすべてのテキスト読み上げ音声を一覧表示します

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

非営利および独立した Web コンテンツを検出するための Marginalia Search へのアクセスを提供し、URL、タイトル、説明を含む固有のサイトを返します。

  1. Features
    1. Installation
      1. Configuration
        1. Usage
          1. search
        2. Response Format
          1. Error Handling
            1. Adding Text-to-Speech Support
              1. For Cline (VSCode Extension)
              2. For Claude Desktop
            2. License
              ID: 3weyx38n1h