AI导哈

研究代理服务器

一个与DedalusLab集成的实时互联网研究代理服务器，提供AI驱动的研究报告生成和实时搜索功能。

  • by Pagent-Money
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 pagent-money/researcher-mcp

使用说明

研究员MCP服务器

与DedalusLab集成的研究代理MCP服务器，用于实时互联网研究- TypeScript实现完全符合 Dedalus Labs MCP服务器指南.

🎯 Dedalus平台就绪

此服务器是 100%合规 遵循Dedalus Labs的指导方针，并准备在Dedalus平台上部署HTTP优先架构。

特性

  • 🔍 实时互联网搜索：使用具有智能回退的SerpAPI进行实时搜索
  • 🤖 人工智能驱动的研究：使用OpenAI GPT模型生成全面的研究报告
  • 🌐 HTTP优先：流式HTTP传输，实现现代网络兼容性
  • 📱 STDIO支持：有利于发展的STDIO运输
  • 🔧 模块化架构：遵循Dedalus准则，将关注点彻底分离
  • 📊 结构化输出：JSON格式的搜索结果和markdown报告
  • 🛡️ 强大的回退：多种回退机制确保可靠性
  • ⚡ 高性能：异步/等待贯穿并发操作
  • 🔒 类型安全：完整的TypeScript类型检查和接口
  • 🏥 生产就绪：健康检查、会话管理、CORS支持

快速开始

安装

git clone <repository-url>
cd researcher-mcp
npm install
npm run build

环境设置

cp env.template .env
# Edit .env with your API keys

所需的环境变量：

OPENAI_API_KEY=your_openai_api_key_here

可选环境变量：

DEDALUS_API_KEY=your_dedalus_api_key_here
SERPAPI_API_KEY=your_serpapi_api_key_here
PORT=8080
NODE_ENV=production

用法

# HTTP server (default - Dedalus compatible)
npm start

# Custom port
researcher-mcp --port 3000

# STDIO mode (development)
researcher-mcp --stdio

# Help
researcher-mcp --help

可用工具

research_topic

使用实时互联网搜索研究一个主题，并生成一份综合报告（<300字）。

参数：

  • topic （必填）：研究主题
  • focus_areas （可选）：要关注的具体领域

例子：

{
  "tool": "research_topic",
  "arguments": {
    "topic": "quantum computing breakthroughs",
    "focus_areas": ["IBM", "Google", "commercial applications"]
  }
}

quick_search

快速在互联网上搜索最新信息。

参数：

  • query （必填）：搜索查询
  • num_results （可选）：要返回的结果数（默认值：5）

例子：

{
  "tool": "quick_search",
  "arguments": {
    "query": "latest AI developments 2024",
    "num_results": 3
  }
}

整合

克劳德桌面（HTTP模式-推荐）

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "researcher": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

克劳德桌面（STDIO模式-开发）

{
  "mcpServers": {
    "researcher": {
      "command": "researcher-mcp",
      "args": ["--stdio"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "SERPAPI_API_KEY": "your-serpapi-api-key"
      }
    }
  }
}

Dedalus平台

该服务器已准备好在Dedalus平台上部署，其HTTP优先架构和兼容结构。

建筑

目录结构（符合Dedalus标准）

src/
├── index.ts            # Main entry point
├── cli.ts              # Command-line argument parsing
├── config.ts           # Configuration management
├── server.ts           # Server instance creation
├── client.ts           # External API client
├── types.ts            # TypeScript type definitions
├── tools/
│   ├── index.ts        # Tool exports
│   └── research.ts     # Tool definitions and handlers
└── transport/
    ├── index.ts        # Transport exports
    ├── http.ts         # HTTP transport (primary)
    └── stdio.ts        # STDIO transport (development)

传输层

主要：流式HTTP传输

  • 端点: /mcp -主MCP通信
  • 健康检查: /health -服务监控
  • 苏格兰和南方能源公司撤退: /sse -服务器发送事件支持
  • 会话管理：基于UUID的会话跟踪
  • CORS支持：Web客户端兼容性

回退：STDIO传输

  • 发展模式: --stdio 旗帜
  • 局部测试：直接过程沟通
  • 向后兼容：适用于现有的STDIO客户端

发展

脚本

npm run build          # Compile TypeScript
npm run watch          # Watch mode compilation
npm start              # Run HTTP server
npm run start:stdio    # Run STDIO server
npm run dev            # Build and run HTTP server
npm run dev:stdio      # Build and run STDIO server
npm test               # Run test client
npm run clean          # Clean build artifacts

测试

局部测试

# Test HTTP server
npm run dev

# Test STDIO server
npm run dev:stdio

# Run test client
npm test

部署测试

# Comprehensive testing with Python scripts
cd examples

# Setup testing environment
./setup_tests.sh

# Test local functionality
python3 test_basic.py

# Test Dedalus deployment (requires API keys)
python3 test_dedalus_deployment.py

有关详细的测试说明，请参阅 examples/TEST_README.md.

Docker支持

# Build and run with Docker
docker build -t researcher-mcp .
docker run -p 8080:8080 --env-file .env researcher-mcp

# Or use docker-compose
docker-compose up -d

API集成详细信息

SerpAPI集成

  • 主要搜索方法 获取实时互联网结果
  • 每个查询最多可处理10个自然结果
  • 错误或速率限制自动回退
  • 免费等级：250次搜索/月

OpenAI集成

  • GPT-4o-mini 用于报告生成和回退搜索
  • 结构化提示，输出一致
  • 温度调节，平衡创造力/准确性
  • 针对简明报告优化了令牌限制

DedalusLab集成

  • 增强的人工智能能力 （可用时）
  • 研究分析的高级工具使用
  • 需要时无缝回退到OpenAI

健康监测

健康检查端点

curl http://localhost:8080/health

答复：

{
  "status": "healthy",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "service": "researcher-mcp",
  "version": "0.2.0"
}

合规

此服务器是 100%合规 随着 Dedalus Labs MCP服务器指南:

  • ✅ 入口点: src/index.ts 作为主要切入点
  • ✅ 仅限TypeScript：完整的TypeScript实现
  • ✅ HTTP传输：流式HTTP传输作为主要方法
  • ✅ MCP SDK版本：使用 @modelcontextprotocol/sdk ^1.17.3
  • ✅ 模块化架构：明确区分关切
  • ✅ 生产就绪：健康检查、会话管理、错误处理

看 DEDALUS_合作_报告.md 进行详细的合规性分析。

需求

  • Node.js: >= 18.0.0
  • TypeScript: >= 5.0.0
  • API密钥：OpenAI（必需）、SerpAPI和DedalusLab（可选）

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 使用正确的TypeScript类型进行更改
  4. 添加新功能的测试
  5. 确保Dedalus合规
  6. 提交拉取请求

支持

对于问题和疑问：

Dedalus平台: ✅ 准备就绪
HTTP传输: ✅ 主要的
STDIO传输: ✅ 发展
生产就绪: ✅ 是

相关 MCP