medadapt-content-server

🚀 医疗自适应内容服务器

这是一个专门为Claude Desktop设计的专业模型上下文协议（MCP）服务器。它通过获取并处理来自PubMed、NCBI Bookshelf以及用户提供的教育资源，极大地增强了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

2. 导航到项目目录：

cd medadapt-content-server

3. 安装依赖项：

pip install -r requirements.txt

💻 使用示例

配置Claude Desktop

1. 打开Claude Desktop。
2. 进入设置，找到MCP服务器配置。
3. 填写以下信息：
   • 名称：医疗自适应内容服务器
   • 地址：localhost:5000
   • 凭据（可选）：如果需要身份验证，请填写相应的凭证
4. 保存配置并启用MCP服务器。

验证连接

1. 启动医疗自适应内容服务器：

python content_server.py

2. 在另一个终端窗口中，运行以下命令以测试与Claude的连接：

curl -X POST http://localhost:5000/api/test

📚 详细文档

可用工具

• PubMed API实用程序：pubmed_utils.py
• NCBI Bookshelf实用程序：bookshelf_utils.py
• 初始主题数据填充脚本：populate_topics.py

故障排除

常见问题及解决方案

1. 数据库路径错误
   • 症状：找不到文件或目录
   • 解决方法：确保在Claude Desktop配置中设置的DB_PATH环境变量为绝对路径，并且应用程序有写入权限。
2. API速率限制
   • 症状：从PubMed或NCBI Bookshelf返回缓慢或失败
   • 解决方法：获取NCBI API密钥并添加到.env文件中
3. Claude Desktop连接问题
   • 症状：Claude无法连接到MCP服务器
   • 解决方法：确认服务器正在运行，并在Claude Desktop中正确配置。

项目结构

医疗自适应内容服务器/
│
├── content_server.py     # 主MCP服务器实现
├── database.py          # SQLite数据库接口
├── pubmed_utils.py      # PubMed API实用程序
├── bookshelf_utils.py   # NCBI Bookshelf实用程序
├── populate_topics.py   # 填充初始主题数据脚本
├── test_server.py       # 测试脚本
├── requirements.txt     # Python依赖项
├── .env.example         # 环境变量示例文件
└── README.md            # 文档说明

📄 许可证

此项目使用MIT许可证，详细信息请参阅LICENSE文件。

致谢

• NCBI提供PubMed和Bookshelf API的访问
• Anthropic提供Claude及其MCP集成功能