返回市场
医疗适应内容服务器

医疗适应内容服务器

作者:ryoureddy6 星标更新:2025-03-28

项目介绍

MedAdapt 内容服务器

针对Claude桌面版的专用模型上下文协议(MCP)服务器,通过获取和处理来自PubMed、NCBI图书架以及用户提供的文档中的教育资源来增强AI辅助医学学习。

概述

MedAdapt内容服务器与Claude桌面版集成,提供搜索、检索和分析医学教育内容的工具。它充当Claude与医学知识来源之间的桥梁,从而实现增强的AI辅助学习体验。

快速开始

# 克隆仓库
git clone https://github.com/ryoureddy/medadapt-content-server.git
cd medadapt-content-server

# 安装依赖
pip install -r requirements.txt

# 运行服务器
python content_server.py

功能

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

安装

标准安装

  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. 配置(可选):

使用

运行服务器

python content_server.py

与Claude桌面版集成

  1. 打开Claude桌面版
  2. 前往设置 → 模型上下文协议 → 添加服务器
  3. 在以下位置的claude_desktop_config.json文件中配置:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "medadapt": {
      "command": "/path/to/python",
      "args": [
        "/path/to/medadapt-content-server/content_server.py"
      ],
      "env": {
        "DB_PATH": "/path/to/medadapt-content-server/medadapt_content.db"
      }
    }
  }
}

替换/path/to/python为实际的Python路径(例如,/opt/anaconda3/bin/pythonC:\Python311\python.exe)。 替换/path/to/medadapt-content-server/为克隆的仓库的实际绝对路径。

重要DB_PATH环境变量确保数据库文件以绝对路径创建和访问,防止常见的文件访问错误。

初始化主题映射

python populate_topics.py

测试

运行测试以验证一切正常:

python test_server.py

示例用法与Claude

场景1:学习医学主题

用户向Claude发出提示:

我想了解心脏循环。你能提供一个总体概述并帮助我理解关键概念吗?

场景2:查找特定资源

用户向Claude发出提示:

我需要找到关于COVID-19治疗选项的最新研究文章。你能帮我找到相关资源吗?

场景3:创建学习计划

用户向Claude发出提示:

我是二年级的医学生,正在学习神经学。你能为我制定一个理解中风病理生理的学习计划吗?

提供的工具

该服务器向Claude提供了以下工具:

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

故障排除

常见问题及解决方案

  1. 数据库连接错误

    • 症状sqlite3.OperationalError: unable to open database file
    • 解决方案:确保在Claude桌面版配置中正确设置了DB_PATH环境变量,指向应用程序有写权限的绝对路径。
  2. 文件路径错误

    • 症状No such file or directory错误
    • 解决方案:确保Claude桌面版配置中的所有路径都是没有额外引号或转义字符的绝对路径。
  3. API速率限制

    • 症状:从PubMed或NCBI图书架获取响应缓慢或失败
    • 解决方案:获取NCBI API密钥并添加到.env文件中
  4. Claude桌面版连接

    • 症状:Claude无法连接到MCP服务器
    • 解决方案:验证服务器是否在终端窗口中运行,并且在Claude桌面版中正确配置

项目结构

medadapt-content-server/
│
├── content_server.py     # 主要的MCP服务器实现
├── database.py          # SQLite数据库接口
├── pubmed_utils.py      # PubMed API实用程序
├── bookshelf_utils.py   # NCBI图书架实用程序
├── populate_topics.py   # 脚本用于填充初始主题数据
├── test_server.py       # 测试脚本
├── requirements.txt     # Python依赖项
├── .env.example         # 示例环境变量
└── README.md            # 文档

许可证

本项目采用MIT许可证 - 查看LICENSE文件以获取详情。

致谢

  • NCBI提供对PubMed和图书架API的访问
  • Anthropic提供Claude和MCP集成能力