Marginalia MCP 服务器

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

特性

• 使用Marginalia Search API搜索网络
• 可配置的搜索参数，包括索引和结果数量
• 带有帮助性错误信息的速率限制保护
• 使用MCP SDK构建，实现无缝集成

安装

npm install
npm run build

配置

该服务器可以通过环境变量进行配置：

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

要请求专用API密钥，请联系：kontakt@marginalia.nu

使用方法

该服务器提供了以下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扩展)

添加到~/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桌面版

添加到~/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文件