Marginalia MCP Server

🚀 边缘注释 MCP 服务器

边缘注释 MCP 服务器借助 Marginalia Search 来实现搜索功能，该搜索引擎专注于挖掘网络上的非商业内容和隐藏瑰宝。此服务器基于模型上下文协议 (MCP) 构建，为用户带来独特的搜索体验。

🚀 快速开始

边缘注释 MCP 服务器是一个强大的工具，可利用 Marginalia 搜索 API 搜索互联网。以下是使用它的基本步骤。

✨ 主要特性

• 强大搜索：使用 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 文件。