边缘注释 MCP 服务器

一个使用 Marginalia Search（专注于搜索网络上的非商业内容和隐藏瑰宝）的模型上下文协议 (MCP) 服务器。

功能

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

安装

npm install
npm run build

配置

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

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

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

使用方法

服务器提供以下 MCP 工具：

搜索

使用 Marginalia 搜索的以下参数搜索互联网：

• 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"
    }
    // ... 更多结果
  ]
}

错误处理

服务器包含 robust 的错误处理功能，包括：

• 速率限制（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 - 有关详细信息，请参阅 LICENSE 文件