MCP AI Research Kit

mcp-ai研究试剂盒

基于Claude Code MCP构建的强大AI研究代理工具包，提供从广泛搜索到深度抓取和交互式执行的完整工作流程。

英语 | 中文

______________________________________________________________________

特性

建筑

┌─────────────────────────────────────────────────────────────┐
│                     Claude Code                              │
└─────────────────────┬───────────────────────────────────────┘
                      │
        ┌─────────────┴─────────────┐
        │      MCP Protocol        │
        └─────────────┬─────────────┘
                      │
    ┌─────────┬───────┴───────┬─────────┬─────────┐
    │         │               │         │         │
    ▼         ▼               ▼         ▼         ▼
┌───────┐ ┌───────┐    ┌──────────┐ ┌──────┐ ┌───────┐
│Search │ │Scraper│    │ Research │ │ Free │ │Trends │
│ Server│ │ Server│    │  Server  │ │Model │ │ Monitor│
└───────┘ └───────┘    └──────────┘ └──────┘ └───────┘
    │         │               │         │         │
    ▼         ▼               ▼         ▼         ▼
┌───────┐ ┌───────┐    ┌──────────┐ ┌──────┐ ┌───────┐
│Tavily │ │Playwrht│    │ Gemini  │ │Open  │ │ SQLite│
│   API │ │        │    │    API  │ │Router│ │       │
└───────┘ └───────┘    └──────────┘ └──────┘ └───────┘

先决条件

1. 克劳德代码 -已安装并配置
2. Python 3.9+ -Anaconda或其他Python环境
3. 剧作家 -浏览器驱动程序（用于网页抓取和自动化）

快速开始

1.克隆存储库

git clone https://github.com/jinhong219220-lab/mcp-ai-research-kit.git
cd mcp-ai-research-kit

2.安装依赖项

# Using Anaconda
conda install -c conda-forge playwright
playwright install chromium

# Or using pip
pip install -r requirements.txt

3.配置API密钥

编辑 config/api_config.yaml 并添加您的API密钥：

# API Configuration
tavily_api_key: "your_TAVILY_API_KEY"
google_api_key: "your_GOOGLE_API_KEY"
openrouter_api_key: "your_OPENROUTER_API_KEY"

4.将MCP服务器添加到Claude代码中

在终端中运行以下命令（根据需要调整Python路径）：

# Add MCP servers
claude mcp add -e TAVILY_API_KEY="your_key" tavily-search -- python "path/to/tavily_mcp.py"
claude mcp add -e GOOGLE_API_KEY="your_key" deep-research -- python "path/to/async_research_mcp.py"
claude mcp add -e OPENROUTER_API_KEY="your_key" free-model -- python "path/to/free_model_mcp.py"
claude mcp add web-scraper -- python "path/to/mcp_server.py"
claude mcp add browser-auto -- python "path/to/browser_mcp.py"
claude mcp add trend-monitor -- python "path/to/trend_monitor_mcp.py"

注： 替换 path/to 使用您的实际文件路径。

用法示例

1.搜索

Use tavily_search to search for Python async programming best practices

参数：

• query：搜索关键字
• search_depth：基本或高级
• max_results：结果数量（1-20）
• topic：一般、新闻或财经

2.网页抓取

Use scrape_url to scrape https://example.com

参数：

• url：目标URL
• platform：微信/小红书/bilibili/通用
• wait_for：要等待的CSS选择器
• extract_text：提取纯文本（默认值：True）

3.购买视频信息

Use get_bilibili_info to get video info for BV1xx411c7mD

4.文本摘要

Use summarize_text to summarize: [paste your text]

5.关键词提取

Use extract_keywords to extract keywords from text

6.趋势监测

Use refresh_trends to refresh trend data
Use get_latest_trends to get trends from last 24 hours

API关键指南

项目结构

mcp-ai-research-kit/
├── mcp_servers/
│   ├── search/
│   │   └── tavily_mcp.py          # Search MCP
│   ├── scraper/
│   │   ├── mcp_server.py          # Scraper MCP
│   │   └── docker-compose.yml     # Docker config
│   ├── browser/
│   │   ├── browser_mcp.py        # Browser automation MCP
│   │   └── skills/               # Skill scripts
│   ├── research/
│   │   └── async_research_mcp.py # Deep research MCP
│   ├── free_model/
│   │   └── free_model_mcp.py     # Free model MCP
│   └── trends/
│       └── trend_monitor_mcp.py  # Trend monitoring MCP
├── config/
│   ├── settings.yaml
│   └── api_config.yaml
├── .gitignore
├── LICENSE
├── README.md
├── CONTRIBUTING.md
└── requirements.txt

贡献

欢迎投稿！请阅读我们的 贡献指南 第一。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

免责声明

此工具仅用于教育和研究目的。在抓取内容时，确保遵守网站的服务条款。

______________________________________________________________________

星⭐ 如果你觉得这有用的话！