Marginalia MCP Server

🚀 边缘注释 MCP 服务器

边缘注释 MCP 服务器是一个基于模型上下文协议 (MCP) 的服务器，它借助 Marginalia Search 进行搜索。Marginalia Search 专注于挖掘网络上的非商业内容和隐藏瑰宝，为用户带来独特的搜索体验。

✨ 主要特性

• 强大搜索能力：借助 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"
    }
    // ... 更多结果
  ]
}

错误处理

服务器具备强大的错误处理功能，涵盖以下方面：

• 速率限制（503 响应）：防止过度请求，保障服务器稳定。
• 无效请求：对无效的请求进行有效拦截和处理。
• 网络错误：及时处理网络异常情况。
• API 特定错误：针对 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 文件。