Marginalia MCP Server

Marginalia MCP サーバー

商用ではないコンテンツや、インターネット上の隠れた逸品を見つけることに重点を置いた検索エンジン、Marginalia SearchにアクセスできるMCP（Model Context Protocol）サーバーです。

機能

• Marginalia Search API を使用したウェブ検索
• インデックスや検索結果数など、検索パラメーターを設定可能
• 分かりやすいエラーメッセージを備えたレート制限保護
• シームレスに統合できるMCP SDKを使用して構築

インストール

npm install
npm run build

設定

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

• MARGINALIA_API_KEY：Marginalia Search API キー（任意。デフォルトではパブリックアクセス）

専用のAPIキーを申請するには、[email protected] までお問い合わせください。

使用方法

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

search

次のパラメーターを使用してMarginalia Searchでウェブを検索します。

• 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 Extension）の場合

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

Claude Desktopの場合

~/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 — 詳細はLICENSEファイルを参照してください