MedAdapt内容服务器

专为 Claude Desktop 设计的模型上下文协议 (MCP) 服务器，通过从 PubMed、NCBI Bookshelf 和用户提供的文档中获取和处理教育资源来增强 AI 辅助医学学习。

概述

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

快速入门

# Clone the repository
git clone https://github.com/ryoureddy/medadapt-content-server.git
cd medadapt-content-server

# Install dependencies
pip install -r requirements.txt

# Run the server
python content_server.py

特征

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

安装

标准安装

克隆存储库：

git clone https://github.com/ryoureddy/medadapt-content-server.git
cd medadapt-content-server

创建虚拟环境（可选但推荐）：

python -m venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

安装依赖项：

pip install -r requirements.txt

配置（可选）：
- 获取 NCBI API 密钥以改进速率限制： https://ncbiinsights.ncbi.nlm.nih.gov/2017/11/02/new-api-keys-for-the-e-utilities/
- 根据.env.example创建.env文件

用法

运行服务器

python content_server.py

与 Claude Desktop 集成

打开 Claude 桌面
前往设置 → 模型上下文协议 → 添加服务器
使用位于以下位置的claude_desktop_config.json文件中的以下 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/python或C:\Python311\python.exe ）。将/path/to/medadapt-content-server/替换为你克隆的存储库的绝对路径。

重要提示： DB_PATH环境变量确保使用绝对路径创建和访问数据库文件，从而防止常见的文件访问错误。

填充初始主题映射

python populate_topics.py

测试

运行测试来验证一切是否正常：

python test_server.py

Claude 的示例用法

场景 1：学习医学主题

用户提示 Claude：

I'd like to learn about the cardiac cycle. Can you provide a big picture overview and help me understand the key concepts?

场景 2：查找特定资源

用户提示 Claude：

I need to find recent research articles about COVID-19 treatment options. Can you help me find relevant resources?

场景3：制定学习计划

用户提示 Claude：

I'm a second-year medical student studying neurology. Can you create a learning plan for understanding stroke pathophysiology?

可用工具

服务器为Claude提供了以下工具：

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

故障排除

常见问题和解决方案

数据库连接错误
- 症状： sqlite3.OperationalError: unable to open database file
- 解决方案：确保在 Claude Desktop 配置中正确设置DB_PATH环境变量，指向应用程序具有写入权限的绝对路径。
文件路径错误
- 症状： No such file or directory错误
- 解决方案：确保 Claude Desktop 配置中的所有路径都是绝对路径，没有多余的引号或转义字符。
API 速率限制
- 症状：PubMed 或 NCBI Bookshelf 响应缓慢或失败
- 解决方案：获取 NCBI API 密钥并将其添加到您的.env文件中
克劳德桌面连接
- 症状：Claude 无法连接到 MCP 服务器
- 解决方案：验证服务器是否在终端窗口中运行，并在 Claude Desktop 中正确配置

项目结构

medadapt-content-server/
│
├── content_server.py     # Main MCP server implementation
├── database.py          # SQLite database interface
├── pubmed_utils.py      # PubMed API utilities
├── bookshelf_utils.py   # NCBI Bookshelf utilities
├── populate_topics.py   # Script to populate initial topic data
├── test_server.py       # Test script
├── requirements.txt     # Python dependencies
├── .env.example         # Example environment variables
└── README.md            # Documentation

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

NCBI 提供对 PubMed 和 Bookshelf API 的访问
克劳德的人类学和 MCP 集成能力

MedAdapt Content Server

Integrations

MedAdapt内容服务器

概述

快速入门

特征

安装

标准安装

用法

运行服务器

与 Claude Desktop 集成

填充初始主题映射

测试

Claude 的示例用法

场景 1：学习医学主题

场景 2：查找特定资源

场景3：制定学习计划

可用工具

故障排除

常见问题和解决方案

项目结构

执照

致谢