旁注MCP服务器

旁注MCP服务器

一个用于管理旁注和注释的MCP服务器实现

旁注MCP服务器

这是一个MCP(模型上下文协议)服务器,提供对Marginalia Search的访问,这是一个专注于发现非商业内容和互联网隐藏宝藏的搜索引擎。

安装

npm install
npm run build

配置

服务器可以通过环境变量配置:

  • MARGINALIA_API_KEY: 你的Marginalia搜索API密钥(可选,默认为公共访问)

使用方法

服务器提供以下MCP工具:

search

使用Marginalia搜索引擎搜索网页,参数:

  • query(必填): 搜索查询字符串
  • index(可选): 搜索索引号
  • count(可选): 返回结果数量(1-100,默认:10)

示例:

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

响应格式

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

{
  "query": "你的搜索查询",
  "license": "许可证信息",
  "results": [
    {
      "url": "结果URL",
      "title": "页面标题",
      "description": "页面描述"
    }
  ]
}