マージナリアMCPサーバー

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

特徴

• Marginalia Search API を使用してウェブを検索する

• インデックスや結果数などの設定可能な検索パラメータ

• 役立つエラーメッセージによるレート制限保護

• シームレスな統合のためにMCP SDKを使用して構築

Related MCP server: SearxNG MCP Server

インストール

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ファイルを参照