AI导哈

本地研究服务器

一个免费的、私密的研究助手，用于AI开发环境，通过DuckDuckGo和Python搜索网络并抓取内容，所有处理均在本地进行以确保隐私。

  • by Unlock-MCP
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Unlock-MCP/local-research-server

使用说明

本地研究MCP服务器

一个免费的私人研究助理，用于人工智能开发环境，使用DuckDuckGo和Python搜索网络并抓取内容。此MCP服务器使AI助手能够访问实时信息，同时将所有处理保持在本地以实现完全隐私。

兼容：

  • 克劳德桌面 -Anthropic的官方桌面应用程序
  • 克劳德代码 -Anthropic面向开发人员的CLI工具
  • Gemini CLI -Gemini的CLI工具
  • 克莱恩 -用于AI驱动编码的VS Code扩展
  • 任何兼容MCP的客户端

特性

  • 🔍 免费网络搜索：使用DuckDuckGo的搜索API而不需要API密钥
  • 📄 内容提取：智能地从网页中提取干净的文本
  • 🔒 隐私第一：所有处理都在您的机器上本地进行
  • ⚡ 快速集成：通过MCP与Claude Desktop无缝协作
  • 🛠️ 零依赖：不需要外部服务或订阅

快速开始

先决条件

  • Python 3.10或更高版本
  • 兼容的AI环境之一：
    • Claude Desktop、Claude Code、Google CLI、Cline或其他MCP客户端
  • 基本的命令行知识

安装

  1. 克隆此存储库：

    git clone https://github.com/Unlock-MCP/local-research-server.git
cd local-research-server

  2. 设置环境：

    uv init
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

  3. 安装依赖项：

    uv add "mcp[cli]" duckduckgo-search trafilatura

  4. 测试服务器：

    python research_server.py

配置

选择您的AI环境：

克劳德桌面

将以下内容添加到您的配置文件中：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "local-researcher": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local-research-server",
        "run",
        "python",
        "research_server.py"
      ]
    }
  }
}

克劳德代码

将此添加到您的 CLAUDE.md 文件或使用CLI：

claude --mcp-server local-researcher="uv --directory /path/to/your/local-research-server run python research_server.py"

谷歌AI工作室/Gemini CLI

通过MCP客户端设置或环境变量进行配置。

Cline（VS代码）

在VS代码设置中添加到Cline MCP服务器配置。

替换 /path/to/your/local-research-server 包含此目录的完整路径。

用法

配置后，重新启动AI环境。连接指示器因平台而异：

  • 克劳德桌面：查找插头图标(🔌)
  • 克劳德代码：CLI输出中显示的服务器状态
  • 其他平台：检查MCP客户端的连接状态

问你的人工智能助理研究问题，比如：

  • “本周人工智能研究的最新进展是什么？”
  • “研究欧洲当前的可再生能源趋势”
  • “查找最近的网络安全威胁报告”

您的AI助手将自动使用本地服务器获取实时信息。

运作原理

服务器实现了一个MCP工具，该工具：

  1. 搜索 使用DuckDuckGo的免费API
  2. 刮掉 来自顶部搜索结果的内容
  3. 提取物 使用Trafilatura编写清晰易读的文本
  4. 退货 将格式化内容发送给Claude进行分析

所有处理都在本地进行，除了公共网络搜索外，没有数据发送到外部服务。

建筑

AI Client (Claude Desktop/Code/Gemini/Cline)
    ↓ (MCP Protocol)
Local Research Server
    ↓ (Search API)
DuckDuckGo Search
    ↓ (HTTP Requests)
Target Websites
    ↓ (Content Extraction)
Clean Text → AI Assistant

配置选项

服务器接受研究工具的这些参数：

  • query （string）：搜索查询或研究主题
  • num_results （int）：要处理的搜索结果数（默认值：3）

安全功能

  • 输入验证：对搜索查询进行消毒
  • 速率限制：网络请求之间的礼貌延迟
  • 错误处理：优雅的故障处理
  • 本地处理：无外部数据依赖关系

业务应用程序

此研究服务器非常适合：

  • 内容创建：研究支持的文章写作
  • 市场分析：实时竞争对手和行业研究
  • 尽职调查：公司和投资研究
  • 监管监测：跟踪合规要求

扩展服务器

考虑以下增强功能：

  • 添加RSS源集成
  • 实现搜索结果缓存
  • 添加域过滤功能
  • 包括发布日期提取
  • 添加多个搜索引擎支持

故障排除

常见问题

服务器未连接：

  • 验证AI客户端配置中的绝对路径
  • 完全重新启动您的AI环境
  • 检查是否安装了Python依赖项

没有搜索结果：

  • 验证互联网连接
  • 检查DuckDuckGo服务状态
  • 尝试不同的搜索查询

内容提取失败：

  • 一些网站阻止抓取
  • 尝试不同来源的不同搜索词
  • 检查控制台输出是否存在特定错误

贡献

我们欢迎捐款！请查看我们的 贡献指南 了解详情。

许可证

MIT许可证-请参阅 许可证 了解详情。

相关项目

支持

相关 MCP