Marginalia MCP Server

Marginalia MCP 服务

一个 MCP（模型上下文协议）服务，可访问 Marginalia Search。这是一款专注于发现非商业内容和互联网隐藏宝藏的搜索引擎。

功能

• 使用 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 扩展）

将以下内容添加到 ~/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 文件