本地研究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客户端
- 基本的命令行知识
安装
- 克隆此存储库：
git clone https://github.com/Unlock-MCP/local-research-server.git
cd local-research-server- 设置环境：
uv init
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate- 安装依赖项：
uv add "mcp[cli]" duckduckgo-search trafilatura- 测试服务器：
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工具，该工具：
- 搜索 使用DuckDuckGo的免费API
- 刮掉 来自顶部搜索结果的内容
- 提取物 使用Trafilatura编写清晰易读的文本
- 退货 将格式化内容发送给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文档服务器 -本地文档访问
- 远程MCP服务器 -企业数据库访问
- UnlockMCP 网站 -MCP教程和资源