[{"_1":2,"_325":-5,"_326":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_257":258},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","6SnjmyOQo3","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_175":176,"_256":107},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","The Search MCP Server enables seamless integration of network and local search capabilities in tools like Claude Desktop and Cursor, utilizing the Brave Search API for high-concurrency and asynchronous requests.","name","Search MCP Server","readme","# Search MCP Server\n\n![image](./images/logo.png)\n\n一个基于MCP协议的搜索服务实现，提供多种搜索引擎支持，Cursor和Claude Desktop能与之无缝集成。\n\n使用Python开发，支持异步处理和高并发请求，目前支持三种搜索引擎选择：\n\n- Brave Search ：国外一家专业提供搜索接口服务产品\n\n- 秘塔（Metaso）搜索：秘塔AI搜索的逆向实现接口，非官方接口\n\n- 博查（bocha）搜索：国内Search API市场占有率最高的搜索API产品\n\n更多MCP知识，见AI全书([ 一文看懂什么是MCP(大模型上下文)？用来干什么的？怎么用它？](https://aibook.ren/archives/mcp-course))\n\n**作者**：凌封（微信fengin）\n\n**网址**：[https://aibook.ren]()（AI全书）\n\n## 使用示例\n\n![image](./images/demo.png)\n\n## 功能特点\n\n- **多搜索引擎支持**: \n - Brave Search: 提供网络搜索和位置搜索\n - Metaso搜索: 提供网络搜索和学术搜索，支持简洁和深入两种模式\n - 博查搜索: 提供网络搜索，支持时间范围过滤、详细摘要和图片搜索\n- **适用场景**: Claude Desktop或者Cursor无缝集成使用，大大扩展工具的内容获取能力\n- **模块化设计**: 每个搜索引擎都是独立的模块，也可以单独拷出去其他地方使用\n\n## 三种搜索的选择\n\n运行时只能生效一种搜索引擎，为了方便大家选择配置哪个上线，我列了下大致的对比：\n\n| 搜索引擎 | 国内/外 | 需魔法 | 自带总结 | 质量 | 免费 | 官方 | 速度 | 注册门槛 |\n| ------ | ---- | --- | ---- | --- | ----- | --- | ------- | ---- |\n| Brave | 国外 | 是 | 否 | 高 | 是(限量) | 是 | 中 | 很高 |\n| Metaso | 国内 | 否 | 是 | 中 | 是 | 否 | 慢(AI总结) | 低 |\n| Bocha | 国内 | 否 | 否 | 高 | 否 | 是 | 极快 | 低 |\n\n## 安装和使用\n\n### 1. 环境要求\n\n- Python 3.10+\n- uv 0.24.0+\n- node.js v20.15.0\n- cursor >=0.45.10 (低于该版本mcp server配置老是连不上)\n- 科学上网（仅使用Brave Search需要）\n\n#### 1.1 安装浏览器驱动(仅Metaso需要)\n\n```\n# 安装Playwright框架\npip install playwright>=1.35.0\n# 安装浏览器驱动,仅安装chromium\nplaywright install chromium\n```\n\n\n\n### 2.下载代码\n\n```bash\ngit clone https://github.com/fengin/search-server.git\n```\n\n### 3. 启用你要的搜索引擎\n\n打开项目根目录，修改server.py以下代码选择启用类型：\n\n```python\n# 搜索引擎配置\nSEARCH_ENGINE = os.getenv(\"SEARCH_ENGINE\", \"bocha\")\n```\n\n其中值分别对应有brave、metaso、bocha，也可以通过配置环境变量SEARCH_ENGIN\n\n### 4\\. 配置对应的搜索模块\n\n以下三个模块目录下都对应有一个config.py文件：\n\n- src\\search\\proxy\\brave\n\n- src\\search\\proxy\\metaso\n\n- src\\search\\proxy\\bocha\n\n根据你的选择，修改对应的config.py文件配置\n\n#### 4.1 brave search配置\n\n```python\n# 检查API密钥\nBRAVE_API_KEY = os.getenv(\"BRAVE_API_KEY\")\nif not BRAVE_API_KEY:\n BRAVE_API_KEY = \"你申请的 brave_api_key\"\n```\n\n在Claude Desktop里面使用的话，也可以在Claude Desktop里配置通过环境变量传这个参数，但是Cursor目前不支持环境变量，只能在这文件里修改\n\nAPI KEY 申请地址：[Brave Search - API](https://api-dashboard.search.brave.com/login)\n\n申请门槛比较高，要求：\n\n- 魔法（使用时也需要）\n\n- 邮箱验证\n\n- 信用卡（可以用虚拟的：[https://cardgenerator.org/](https://cardgenerator.org/)）\n\n#### 4.2 秘塔(metaso)配置\n\n```python\n# 认证信息\nMETASO_UID = os.getenv(\"METASO_UID\")\nMETASO_SID = os.getenv(\"METASO_SID\")\nif not METASO_UID or not METASO_SID:\n METASO_UID = \"你获取的 metaso_uid\"\n METASO_SID = \"你获取的 metaso_sid\"\n```\n\n同样Claude Desktop使用可以通过 MCP Servers配置里环境变量；\n\n**uid和sid获取方式：**\n\n进入秘塔AI搜索，登录账号（建议登录账号，否则可能遭遇奇怪的限制），然后F12打开开发者工具，从Application > Cookies中找到`uid`和`sid`的值。\n\n![获取uid-sid](./images/meta-uid-sid.png)\n\n**多账号接入**\n\n注意：目前怀疑秘塔对IP地址的总搜索次数有限制，建议加入IP轮换\n\n你可以通过提供多个账号的uid-sid并使用`,`修改下相关的使用代码，每次请求服务会从中挑选一个，本人后续再考虑。\n\n#### 4.3 博查(bocha)配置\n\n```python\nBOCHA_API_KEY = os.getenv(\"BOCHA_API_KEY\", \"\")\nif not BOCHA_API_KEY:\n BOCHA_API_KEY=\"你申请的 bocha_api_key\"\n```\n\n注册申请地址：https://open.bochaai.com/\n\n调用按次数收费，不便宜，但是搜索质量确实比较好，我这有少量的免费试用码，有需要的微信联系我；\n\n### 5. AI工具配置\n\n#### 5.1 Cursor里配置\n\n![Cursor配置](./images/cursor-mcp-server.png)\n\n- name: search\n\n- type: cmd\n\n- command: uv --directory D:\\\\code\\\\search-server run search\n\n其中 “D:\\code\\search-server” 就是你拉下来源代码目录\n\n#### 5.2 Claude Desktop配置\n\n找到配置文件\n\n**方法一**\n\n```\n# widnows\nC:\\Users\\{用户}\\AppData\\Roaming\\Claude\\claude_desktop_config.json\n# mac/linux 应该在用户家目录下找\n```\n\n**方法二**\n\n打开Claude Desktop应用进入查看：\nClaude Desktop—>菜单—>Settings—>Developer—>Edit Config\n\n编辑增加以下MCP Server:\n\n```json\n{\n \"mcpServers\": {\n \"search\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"D:\\\\code\\\\search-server\",\n \"run\",\n \"search\"\n ],\n \"env\": {\n \"BRAVE_API_KEY\": \"你申请的API KEY\"\n }\n }\n }\n}\n```\n\n环境变量看你需要，如果代码改了这就没必要配置了\n\nCursor会弹出一个黑窗口，不要关闭，不要关闭，这是启动的MCP Server进程，目前没办法解决不弹出来。\n\nClaude Desktop配置完一定要重启应用才生效。\n\n#### 5.4 问题排错\n\n配置Cursor后很多人遇到，MCP Servers里面配置完，还是显示状态红点，Tools Not Found，使用时也不会去调用，这是因为根本没配置好。\n\n大部分可能出现的情况是：\n\n1. 环境没准备好，包括需要的软件及版本要求，详见环境章节\n\n2. 准备的环境不对，像windows有cmd终端、powershell终端、还有可能装了gitbash终端，你打开cmd终端（cursor一般是这个）检查下环境，直接运行下uv --directory D:\\code\\search-server run search\n\n3. 配置路径/命令不对，可以打开终端运行命令看下：uv --directory D:\\code\\search-server run search\n\n4. 把黑窗口关闭了，再次开启需要重启Cursor\n\n5. Cursor版本太旧\n\n6. 运行时报以下错，原因是没有安装chromium，解决办法见环境准备1.1章节\n \n ```shell\n 错误:搜索执行错误:BrowserType.launch persistent context:Executable doesn't exist atC:\\Users\\fengi\\AppDatalLocal\\ms-playwright\\chromium headless shell-1155\\chrome-winlheadless shell.exe\n ```\n\n### 6. 使用\n\n在你的Claude Desktop 或者 Cursor 里直接你正常的工作就行了，必要时它会自动调用搜索接口获取内容，比如说，你整理下网络上2025年技术发展方向作为软件什么内容，它就会去调用搜索工具获取网络信息：\n\n- 配置好工具后，它的信息里面就知道有这个工具\n\n- 根据你的要求，它自动会分析判断需要用到搜索工具\n\n- 根据需求，提取关键词，调用搜索工具\n\n- 根据搜索返回内容，组织你要的结果\n\n有一点需要注意的，在Cursor里面，必须启用composer的agent模式工作才会生效，调用工具时，也需要你点下执行；\n\n## 技术内幕\n\n### 项目结构\n\n```shell\nsearch/\n├── __init__.py\n├── server.py # MCP服务器实现\n└── proxy/ # 搜索引擎代理\n ├── brave/ # Brave搜索模块\n │ ├── __init__.py\n │ ├── client.py # 核心客户端实现\n │ ├── config.py # 配置和速率限制\n │ └── exceptions.py # 异常定义\n ├── metaso/ # Metaso搜索模块\n │ ├── __init__.py\n │ ├── client.py # 核心客户端实现\n │ ├── config.py # 配置和速率限制\n │ └── exceptions.py # 异常定义\n ├── bocha/ # 博查搜索模块\n │ ├── __init__.py\n │ ├── client.py # 核心客户端实现\n │ ├── config.py # 配置和速率限制\n │ └── exceptions.py # 异常定义\n ├── brave_search.py # Brave MCP工具实现\n ├── metaso_search.py # Metaso MCP工具实现\n └── bocha_search.py # 博查搜索MCP工具实现\n```\n\n### 接口参数\n\n#### Brave Search引擎\n\n- **search**\n \n - 执行网络搜索，支持分页和过滤\n - 输入参数:\n - `query` (string): 搜索关键词\n - `count` (number, 可选): 每页结果数量(最大20)\n - `offset` (number, 可选): 分页偏移量(最大9)\n\n- **location_search**\n \n - 搜索地理位置相关信息（商家、餐厅等）\n - 输入参数:\n - `query` (string): 位置搜索关键词\n - `count` (number, 可选): 结果数量(最大20)\n - 无相关结果时自动切换到网络搜索\n\n#### Metaso搜索引擎\n\n- **search**\n \n - 执行网络搜索，支持多种模式\n - 输入参数:\n - `query` (string): 搜索关键词\n - `mode` (string, 可选): 搜索模式\n - `concise`: 简洁模式，回答简短精炼\n - `detail`: 深入模式，回答详细全面（默认）\n - `research`: 研究模式，回答深度分析（目前暂不支持，逆向没有成功）\n\n- **scholar_search**\n \n - 执行学术搜索，专门用于查找学术资源\n - 输入参数:\n - `query` (string): 学术搜索关键词\n - `mode` (string, 可选): 搜索模式，同上\n\n#### 博查搜索引擎\n\n- **search**\n - 执行网络搜索，支持时间范围过滤和详细摘要\n - 输入参数:\n - `query` (string): 搜索关键词\n - `count` (number, 可选): 结果数量(1-10，默认10)\n - `page` (number, 可选): 页码，从1开始\n - `freshness` (string, 可选): 时间范围\n - `noLimit`: 不限时间（默认）\n - `oneDay`: 一天内\n - `oneWeek`: 一周内\n - `oneMonth`: 一月内\n - `oneYear`: 一年内\n - `summary` (boolean, 可选): 是否显示详细摘要，默认false\n - 返回内容:\n - 搜索统计信息（总结果数、当前页/总页数、本页结果数）\n - 网页搜索结果（标题、URL、来源、摘要、发布时间）\n - 相关图片信息（尺寸、来源、URL）\n\n## ","English","tag","en-US",{"_41":42,"_43":44,"_13":69,"_74":32,"_75":32,"_76":77,"_80":81,"_103":-5,"_104":105,"_106":107,"_108":109,"_33":34,"_120":94,"_121":-5,"_122":-5,"_123":124,"_125":-5,"_126":127,"_132":-5,"_116":90,"_133":134,"_137":138,"_17":172,"_173":174},"addedAt",["D",1739336405764],"argumentsJsonSchema",{"_45":46,"_66":67,"_50":68},"properties",{"_47":48,"_52":53,"_55":56,"_58":59,"_61":62},"METASO_SID",{"_31":49,"_50":51},"SID for Metaso search","type","string","METASO_UID",{"_31":54,"_50":51},"UID for Metaso search","BOCHA_API_KEY",{"_31":57,"_50":51},"API key for Bocha search","BRAVE_API_KEY",{"_31":60,"_50":51},"API key for Brave Search","SEARCH_ENGINE",{"_63":64,"_31":65,"_50":51},"default","bocha","The search engine to use","required",[],"object",[70,71,72,73],"category:search","hosting:hybrid","language:python","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":36,"_78":79},"url","https://github.com/fengin/search-server","githubRepository",{"_82":83,"_84":85,"_86":87,"_88":89,"_33":90,"_91":92,"_96":97,"_98":99,"_101":102},"defaultBranch","main","fullName","fengin/search-server","githubTreeId",74624,"language","Python","search-server","owner",{"_93":94,"_17":95},"login","fengin","oilpxca8nw","recentStargazers",5,"spdxLicense",{"_33":100},"MIT License","stargazers",52,"glamaJson","id",945,"inspectable",false,"integrations",[110],{"_111":112,"_31":118,"_17":119},"brand",{"_113":114,"_33":115,"_116":117},"logoSvgPath","M15.68 0l2.096 2.38s1.84-.512 2.709.358c.868.87 1.584 1.638 1.584 1.638l-.562 1.381.715 2.047s-2.104 7.98-2.35 8.955c-.486 1.919-.818 2.66-2.198 3.633-1.38.972-3.884 2.66-4.293 2.916-.409.256-.92.692-1.38.692-.46 0-.97-.436-1.38-.692a185.796 185.796 0 01-4.293-2.916c-1.38-.973-1.712-1.714-2.197-3.633-.247-.975-2.351-8.955-2.351-8.955l.715-2.047-.562-1.381s.716-.768 1.585-1.638c.868-.87 2.708-.358 2.708-.358L8.321 0h7.36zm-3.679 14.936c-.14 0-1.038.317-1.758.69-.72.373-1.242.637-1.409.742-.167.104-.065.301.087.409.152.107 2.194 1.69 2.393 1.866.198.175.489.464.687.464.198 0 .49-.29.688-.464.198-.175 2.24-1.759 2.392-1.866.152-.108.254-.305.087-.41-.167-.104-.689-.368-1.41-.741-.72-.373-1.617-.69-1.757-.69zm0-11.278s-.409.001-1.022.206-1.278.46-1.584.46c-.307 0-2.581-.434-2.581-.434S4.119 7.152 4.119 7.849c0 .697.339.881.68 1.243l2.02 2.149c.192.203.59.511.356 1.066-.235.555-.58 1.26-.196 1.977.384.716 1.042 1.194 1.464 1.115.421-.08 1.412-.598 1.776-.834.364-.237 1.518-1.19 1.518-1.554 0-.365-1.193-1.02-1.413-1.168-.22-.15-1.226-.725-1.247-.95-.02-.227-.012-.293.284-.851.297-.559.831-1.304.742-1.8-.089-.495-.95-.753-1.565-.986-.615-.232-1.799-.671-1.947-.74-.148-.068-.11-.133.339-.175.448-.043 1.719-.212 2.292-.052.573.16 1.552.403 1.632.532.079.13.149.134.067.579-.081.445-.5 2.581-.541 2.96-.04.38-.12.63.288.724.409.094 1.097.256 1.333.256s.924-.162 1.333-.256c.408-.093.329-.344.288-.723-.04-.38-.46-2.516-.541-2.961-.082-.445-.012-.45.067-.579.08-.129 1.059-.372 1.632-.532.573-.16 1.845.009 2.292.052.449.042.487.107.339.175-.148.069-1.332.508-1.947.74-.615.233-1.476.49-1.565.986-.09.496.445 1.241.742 1.8.297.558.304.624.284.85-.02.226-1.026.802-1.247.95-.22.15-1.413.804-1.413 1.169 0 .364 1.154 1.317 1.518 1.554.364.236 1.355.755 1.776.834.422.079 1.08-.4 1.464-1.115.384-.716.039-1.422-.195-1.977-.235-.555.163-.863.355-1.066l2.02-2.149c.341-.362.68-.546.68-1.243 0-.697-2.695-3.96-2.695-3.96s-2.274.436-2.58.436c-.307 0-.972-.256-1.585-.461-.613-.205-1.022-.206-1.022-.206z","Brave","slug","brave","Provides integration with Brave Search API, allowing users to perform web and location searches through the Brave Search engine.","6k2foanyoa","namespace","npmPackage","prompts","redditPostForeignId","1injbby","resources","scores",{"_128":129,"_130":-5,"_131":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[135,136],"LINUX","WINDOWS","tools",[139],{"_33":140,"_31":141,"_142":143},"search","执行网页搜索，从全网搜索任何网页信息和网页链接。结果准确、摘要完整，更适合AI使用。支持以下特性：\n- 时间范围过滤\n- 显示详细摘要\n- 分页获取\n每次请求最多返回10个结果。（当前使用博查搜索API实现）","inputSchema",{"_50":68,"_66":144,"_45":146},[145],"query",{"_147":148,"_152":153,"_145":156,"_158":159,"_162":163},"page",{"_50":149,"_63":150,"_31":151},"number",1,"页码，从1开始","count",{"_50":149,"_63":154,"_31":155},10,"结果数量(1-10，默认10)",{"_50":51,"_31":157},"搜索查询内容","summary",{"_50":160,"_63":107,"_31":161},"boolean","是否显示详细摘要","freshness",{"_164":165,"_50":51,"_63":166,"_31":171},"enum",[166,167,168,169,170],"noLimit","oneDay","oneWeek","oneMonth","oneYear","时间范围(noLimit:不限, oneDay:一天内, oneWeek:一周内, oneMonth:一月内, oneYear:一年内)","x9pd5cqiyx","updatedAt",["D",1742492101494],"meta",[177,180,182,189,192,194,197,200,203,206,209,211,214,217,219,221,223,225,227],{"_178":179},"title","Search MCP Server | Glama",{"_181":32,"_33":31},"content",{"_183":184,"_185":186,"_187":188},"href","https://glama.ai/mcp/servers/@fengin/search-server","rel","canonical","tagName","link",{"_181":34,"_190":191},"property","og:title",{"_181":32,"_190":193},"og:description",{"_181":195,"_190":196},"https://glama.ai/logo.png","og:logo",{"_181":198,"_190":199},"https://glama.ai/mcp/servers/@fengin/search-server/og-image","og:image",{"_181":201,"_190":202},"630","og:image:height",{"_181":204,"_190":205},"1200","og:image:width",{"_181":207,"_190":208},"website","og:type",{"_181":184,"_190":210},"og:url",{"_181":212,"_190":213},"ChatGPT alternative for power users","og:site_name",{"_181":215,"_33":216},"summary_large_image","twitter:card",{"_181":212,"_33":218},"twitter:title",{"_181":32,"_33":220},"twitter:description",{"_181":198,"_33":222},"twitter:image",{"_181":201,"_33":224},"twitter:image:height",{"_181":204,"_33":226},"twitter:image:width",{"_228":229},"script:ld+json",{"_230":231,"_232":233},"@context","http://schema.org","@graph",[234],{"_230":235,"_236":237,"_238":239},"https://schema.org","@type","BreadcrumbList","itemListElement",[240,246,250,254],{"_236":241,"_242":243,"_33":244,"_245":150},"ListItem","item","https://glama.ai/","Glama","position",{"_236":241,"_242":247,"_33":248,"_245":249},"https://glama.ai/mcp","MCP",2,{"_236":241,"_242":251,"_33":252,"_245":253},"https://glama.ai/mcp/servers","Servers",3,{"_236":241,"_242":184,"_33":34,"_245":255},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_26":-5,"_29":259,"_175":291,"_324":-5},{"_41":260,"_43":261,"_13":269,"_74":32,"_75":32,"_76":270,"_80":271,"_103":-5,"_104":105,"_106":107,"_108":274,"_33":34,"_120":94,"_121":-5,"_122":-5,"_123":124,"_125":-5,"_126":277,"_132":-5,"_116":90,"_133":278,"_137":279,"_17":172,"_173":290},["D",1739336405764],{"_45":262,"_66":268,"_50":68},{"_47":263,"_52":264,"_55":265,"_58":266,"_61":267},{"_31":49,"_50":51},{"_31":54,"_50":51},{"_31":57,"_50":51},{"_31":60,"_50":51},{"_63":64,"_31":65,"_50":51},[],[70,71,72,73],{"_35":36,"_78":79},{"_82":83,"_84":85,"_86":87,"_88":89,"_33":90,"_91":272,"_96":97,"_98":273,"_101":102},{"_93":94,"_17":95},{"_33":100},[275],{"_111":276,"_31":118,"_17":119},{"_113":114,"_33":115,"_116":117},{"_128":129,"_130":-5,"_131":-5},[135,136],[280],{"_33":140,"_31":141,"_142":281},{"_50":68,"_66":282,"_45":283},[145],{"_147":284,"_152":285,"_145":286,"_158":287,"_162":288},{"_50":149,"_63":150,"_31":151},{"_50":149,"_63":154,"_31":155},{"_50":51,"_31":157},{"_50":160,"_63":107,"_31":161},{"_164":289,"_50":51,"_63":166,"_31":171},[166,167,168,169,170],["D",1742492101494],[292,294,295,297,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313],{"_178":293},"Reviews | Search MCP Server | Glama",{"_181":32,"_33":31},{"_183":296,"_185":186,"_187":188},"https://glama.ai/mcp/servers/@fengin/search-server/reviews",{"_181":298,"_190":191},"Reviews | Search MCP Server",{"_181":32,"_190":193},{"_181":195,"_190":196},{"_181":198,"_190":199},{"_181":201,"_190":202},{"_181":204,"_190":205},{"_181":207,"_190":208},{"_181":296,"_190":210},{"_181":212,"_190":213},{"_181":215,"_33":216},{"_181":212,"_33":218},{"_181":32,"_33":220},{"_181":198,"_33":222},{"_181":201,"_33":224},{"_181":204,"_33":226},{"_228":314},{"_230":231,"_232":315},[316],{"_230":235,"_236":237,"_238":317},[318,319,320,321,322],{"_236":241,"_242":243,"_33":244,"_245":150},{"_236":241,"_242":247,"_33":248,"_245":249},{"_236":241,"_242":251,"_33":252,"_245":253},{"_236":241,"_242":184,"_33":34,"_245":255},{"_236":241,"_242":296,"_33":323,"_245":97},"Reviews","review","actionData","errors"]

Rate & Review