Marginalia MCP Server

Marginalia MCP服务器

MCP（模型上下文协议）服务器，提供对以下内容的访问 边缘搜索，一个专注于寻找非商业内容和互联网隐藏瑰宝的搜索引擎。

特性

• 使用Marginalia Search API搜索网页
• 可配置的搜索参数，包括索引和结果计数
• 具有有用错误消息的速率限制保护
• 使用MCP SDK构建，实现无缝集成

安装

npm install
npm run build

配置

可以使用环境变量配置服务器：

• MARGINALIA_API_KEY：您的Marginalia Search API密钥（可选，默认为公共访问）

如需申请API专用密钥，请联系：kontakt@marginalia.nu

用法

服务器提供以下MCP工具：

搜索

使用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特定错误

添加文本到语音支持

要使用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"]
    }
  }
}

MCP服务器提供多种语音和语言的文本转语音功能。可用工具：

• speak：使用指定的语音和速率大声朗读文本
• list_voices：列出所有可用的文本转语音

许可证

MIT许可证-有关详细信息，请参阅许可证文件