DeepCritical 使用说明
项目简介
DeepCritical是一个先进的AI驱动药物再利用研究平台。它旨在加速药物发现过程,通过整合来自PubMed、ClinicalTrials.gov和Europe PMC等多个生物医学数据库的信息,并利用大型语言模型(LLM)进行智能分析。该平台能够自动评估研究证据、生成潜在的药物作用机制假设,并最终撰写结构化的科学研究报告。DeepCritical还通过实现Model Context Protocol (MCP) 规范,将其核心搜索和分析工具暴露给LLM客户端,例如Claude Desktop,使得LLM能够直接调用这些外部功能,获取上下文信息或执行特定任务。
主要功能点
- 多源生物医学搜索: 同时搜索PubMed(同行评审文献)、ClinicalTrials.gov(临床试验数据)和Europe PMC(包含生物预印本如bioRxiv/medRxiv以及开放获取文献),全面、实时地收集研究证据。
- AI驱动证据评估: 利用LLM对收集到的海量文献和数据进行智能评估,判断证据的质量和充分性,以决定是否继续搜索或进行下一步分析。
- 智能假设生成: 基于已收集的证据,LLM能够生成关于药物作用机制的科学假设,例如“药物 -> 靶点 -> 通路 -> 治疗效果”,指导深入研究。
- 结构化科学报告撰写: 综合整个研究过程的发现,LLM自动生成包含执行摘要、方法论、关键发现、候选药物、局限性和结论的专业科学报告,并对引用进行严格校验,防止幻觉。
- 安全沙盒代码执行: 利用Modal平台提供安全、隔离的环境,执行AI生成的Python统计代码,进行复杂的数据分析和验证。
- MCP服务器集成: 将平台强大的搜索(如PubMed、临床试验搜索)和分析(如假设分析)工具作为标准化的MCP工具对外暴露,支持LLM客户端直接通过JSON-RPC协议进行调用。
安装步骤
- 准备Python环境: 确保您的系统已安装Python 3.11版本。
- 安装'uv'包管理器: 如果您的系统中尚未安装'uv',请通过以下命令安装:
pip install uv - 克隆项目仓库:
git clone https://github.com/The-Obstacle-Is-The-Way/DeepCritical-HFSpace.git cd DeepCritical-HFSpace - 同步项目依赖:
uv sync - 配置API密钥(可选):
- 为获得更强大的LLM驱动分析能力,请在项目根目录下创建一个名为'.env'的文件,并配置您的OpenAI或Anthropic API密钥:
OPENAI_API_KEY=sk-... # 或者 ANTHROPIC_API_KEY=sk-ant-... - 如果您不配置,DeepCritical将默认使用HuggingFace Inference的免费模型进行AI分析。
- 为启用沙盒代码执行功能,请在'.env'文件中配置Modal平台的凭据:
MODAL_TOKEN_ID=your_modal_token_id MODAL_TOKEN_SECRET=your_modal_token_secret
- 为获得更强大的LLM驱动分析能力,请在项目根目录下创建一个名为'.env'的文件,并配置您的OpenAI或Anthropic API密钥:
服务器配置(MCP客户端使用)
DeepCritical应用启动后,其MCP服务器将在 'http://localhost:7860/gradio_api/mcp/' 地址监听客户端请求。您可以将以下JSON配置添加到您的MCP客户端(如Claude Desktop)中,使LLM能够识别并调用DeepCritical提供的工具:
{ "mcpServers": { "deepcritical_research_agent": { "url": "http://localhost:7860/gradio_api/mcp/", "command": "uv", "args": ["run", "python", "src/app.py"], "description": "AI驱动的药物再利用研究代理,提供多源生物医学搜索(PubMed, ClinicalTrials.gov, bioRxiv/medRxiv)和假设分析工具。" } } }
说明:
- '"deepcritical_research_agent"': 这是您在MCP客户端中为DeepCritical服务器指定的一个可读名称。
- '"url"': 指示MCP服务器监听的地址。
- '"command"': 启动DeepCritical服务器的可执行命令。
- '"args"': 启动命令的参数列表。
- '"description"': 对该MCP服务器功能的简要描述,方便用户理解其用途。
基本使用方法
- 启动DeepCritical应用:
在项目根目录下执行以下命令启动Gradio应用程序:
uv run python src/app.py - 访问用户界面: 应用启动后,在您的浏览器中访问 'http://localhost:7860' 即可使用DeepCritical的交互式Web界面。
- 通过MCP客户端调用工具:
根据上述“服务器配置”部分的信息,在您的MCP客户端中完成配置。连接成功后,您可以通过LLM客户端直接调用DeepCritical暴露的工具,例如:
- 'search_pubmed(query="metformin Alzheimer's disease", max_results=5)'
- 'search_clinical_trials(query="diabetes phase 3", max_results=3)'
- 'search_biorxiv(query="long covid mechanism", max_results=2)' (等同于 'search_europepmc')
- 'search_all(query="aspirin cancer prevention", max_per_source=2)'
- 'analyze_hypothesis(drug="metformin", condition="diabetes", evidence_summary="Metformin lowers blood glucose in type 2 diabetes by activating AMPK.")' 这些工具将直接向您的LLM客户端返回结构化的研究信息或分析结果。
信息
分类
AI与计算