Marginalia MCP Server

基本能力

产品定位

Marginalia MCP Server 是一个提供 Marginalia Search API 访问的 MCP 服务器，专注于非商业内容和互联网隐藏宝藏的搜索。

核心功能

• 使用 Marginalia Search API 进行网络搜索
• 可配置的搜索参数，包括索引和结果数量
• 速率限制保护，并提供有用的错误信息
• 使用 MCP SDK 构建，便于集成

适用场景

• 开发需要集成 Marginalia Search API 的应用
• 需要搜索非商业内容和互联网隐藏宝藏的场景

工具列表

• search: 使用 Marginalia Search 进行网络搜索，支持查询字符串、索引和结果数量等参数。

常见问题解答

• 如何获取 API 密钥？联系 [email protected] 请求专用 API 密钥。
• 如何处理速率限制？服务器会返回 503 响应，并提供有用的错误信息。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

npm install
npm run build

配置

通过环境变量配置服务器： - MARGINALIA_API_KEY: 您的 Marginalia Search API 密钥（可选，默认为公共访问）

调试方式

使用 MCP 工具进行搜索示例：

const result = await mcp.useTool("marginalia", "search", {
  query: "interesting non-commercial websites",
  count: 5
});

添加文本转语音支持

对于 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"]
    }
  }
}

文本转语音工具

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。