MedAdapt Content Server

MedAdapt Content Server

site icon
2025.03.28 2
Python医学教育AI辅助学习内容生成
MedAdapt Content Server 是一个专为 Claude Desktop 设计的 Model Context Protocol (MCP) 服务器,旨在通过从 PubMed、NCBI Bookshelf 和用户提供的文档中获取和处理教育资源,增强 AI 辅助的医学学习体验。该服务器作为 Claude 与医学知识源之间的桥梁,提供搜索、检索和分析医学教育内容的工具。
View on GitHub

Overview

基本能力

产品定位

MedAdapt Content Server 是一个专为医学教育设计的 AI 辅助工具,通过与 Claude Desktop 集成,提供医学知识搜索、资源检索和学习计划创建等功能。

核心功能

  • 内容搜索:在多个来源中搜索医学教育内容
  • 资源检索:获取完整的文章、书籍章节和用户文档
  • 主题概述:生成医学主题的全面概述
  • 学习资源建议:根据主题和学生水平推荐适当的学习资源
  • 学习计划创建:创建包含目标和资源的结构化学习计划
  • 内容分析:从医学资源中提取关键点、方法和发现
  • 用户内容导入:导入和分析用户提供的文档

适用场景

  • 医学学生或专业人士学习特定医学主题
  • 查找最新的医学研究文章
  • 创建个性化的学习计划
  • 分析医学文章的关键点

工具列表

  • search_medical_content:搜索医学内容(带过滤器)
  • get_resource_content:检索特定资源的完整内容
  • get_topic_overview:生成医学主题的全面概述
  • suggest_learning_resources:获取个性化资源推荐
  • import_user_document:上传用户提供的学习材料
  • generate_learning_plan:创建结构化学习计划
  • extract_article_key_points:从医学文章中提取关键发现

常见问题解答

  1. 数据库连接错误
  2. 症状:sqlite3.OperationalError: unable to open database file
  3. 解决方案:确保 DB_PATH 环境变量正确设置,指向应用程序有写入权限的绝对路径

  4. 文件路径错误

  5. 症状:No such file or directory 错误
  6. 解决方案:确保所有路径都是绝对路径,没有额外的引号或转义字符

  7. API 速率限制

  8. 症状:PubMed 或 NCBI Bookshelf 响应缓慢或失败
  9. 解决方案:获取 NCBI API 密钥并添加到 .env 文件

  10. Claude Desktop 连接问题

  11. 症状:Claude 无法连接到 MCP 服务器
  12. 解决方案:验证服务器是否在终端窗口中运行,并在 Claude Desktop 中正确配置

使用教程

使用依赖

  1. 确保已安装 Python 和 Git

安装教程

  1. 克隆仓库:
git clone https://github.com/ryoureddy/medadapt-content-server.git
cd medadapt-content-server
  1. 创建虚拟环境(可选但推荐):
python -m venv .venv
source .venv/bin/activate  # Windows 上使用: .venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt
  1. 配置(可选):
  2. 获取 NCBI API 密钥以提高速率限制
  3. 基于 .env.example 创建 .env 文件

调试方式

  1. 运行服务器:
python content_server.py
  1. 运行测试:
python test_server.py
  1. 填充初始主题映射:
python populate_topics.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。