Marginalia MCP Server

🚀 邊緣註釋 MCP 服務器

邊緣註釋 MCP 服務器是一個基於模型上下文協議 (MCP) 的服務器，它藉助 Marginalia Search 進行搜索。Marginalia Search 專注於挖掘網絡上的非商業內容和隱藏瑰寶，為用戶帶來獨特的搜索體驗。

✨ 主要特性

• 強大搜索能力：藉助 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 特定錯誤：針對 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"]
    }
  }
}

對於 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 文件。