MCP 服务器

Marginalia MCP Server

提供 Marginalia Search 的访问权限，用于发现非商业和独立的网络内容，返回包含 URL、标题和描述的独特网站。

媒体内容处理

编程文档访问

内容获取

访问服务器

Tools

search-marginalia

Search the web using Marginalia Search

README

Marginalia MCP 服务器

一个 MCP (模型上下文协议) 服务器，提供对 Marginalia Search 的访问。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": "您的搜索查询",
  "license": "许可信息",
  "results": [
    {
      "url": "结果 URL",
      "title": "页面标题",
      "description": "页面描述"
    }
    // ... 更多结果
  ]
}

错误处理

服务器包括强大的错误处理功能，用于处理：

速率限制（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"]
    }
  }
}