边缘注释MCP服务器

这是一个基于MCP（模型上下文协议）的服务器，提供对Marginalia Search的访问，这是一款专注于查找非商业内容和互联网隐藏宝藏的搜索引擎。

特性

• 使用Marginalia Search API搜索网络
• 可配置的搜索参数，包括索引和结果数量
• 带有帮助信息的速率限制保护
• 使用MCP SDK构建，实现无缝集成

安装

npm install
npm run build

配置

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

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

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

使用方法

该服务器提供了以下MCP工具：

搜索

使用Marginalia Search搜索网络，参数如下：

• query（必需）：搜索查询字符串
• index（可选）：搜索索引编号（对应于主GUI中的下拉菜单）
• count（可选）：返回的结果数量（1-100，默认值：10）

通过MCP使用的示例：

const result = await mcp.useTool("marginalia", "search", {
  query: "有趣的非商业网站",
  count: 5
});

响应格式

搜索结果以以下格式返回：

{
  "query": "你的搜索查询",
  "license": "许可信息",
  "results": [
    {
      "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桌面版

添加到~/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文件