Marginalia MCP Server

🚀 エッジ注釈 MCP サーバー

このサーバーは、Marginalia Search（ウェブ上の非商業コンテンツや隠れた宝物を検索することに特化）を使用したモデルコンテキストプロトコル (MCP) サーバーです。

✨ 主な機能

• Marginalia 検索 API を使用してインターネットを検索します。
• インデックスや結果数など、検索パラメータを設定可能です。
• レート制限保護と有用なエラーメッセージを備えています。
• MCP SDK を使用して構築されており、シームレスな統合が可能です。

📦 インストール

npm install
npm run build

📚 ドキュメント

設定

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

• MARGINALIA_API_KEY：あなたの Marginalia 検索 API キー（オプション、デフォルトは公共アクセス）

専用の API キーを取得するには、kontakt@marginalia.nu までお問い合わせください。

使用方法

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

検索

Marginalia 検索の以下のパラメータを使用してインターネットを検索します。

• 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"
    }
    // ... 更多结果
  ]
}

エラー処理

サーバーには堅牢なエラー処理機能が含まれており、以下のエラーに対応しています。

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

テキスト読み上げ機能の追加

say MCP サーバーを使用したテキスト読み上げ機能を有効にするには、以下の設定を追加してください。

クライアント（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"]
    }
  }
}

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 ファイルを参照してください。