Question Bank MCP

题库MCP服务器

用于使用IRT元数据管理K-12评估题库的MCP服务器。使用完整的Bloom分类法、难度校准和主题标记构建、组织和搜索试题——所有这些都可以通过Claude的自然语言完成。

什么是MCP？

模型上下文协议 （MCP）是一个开放标准，允许像Claude这样的人工智能助手连接到外部工具和数据源。此服务器使Claude能够直接创建、管理和查询题库，而无需复制粘贴或手动数据输入。

特性

• CRUD问题 --使用完整元数据创建、阅读、更新和删除问题
• 问题类型 --多项选择、真/假、简答题和短文
• 分类学 --对所有6个认知水平的问题进行分类（通过创建记住）
• 校准困难 --连续0.0–1.0刻度，带易/中/硬桶
• IRT元数据 — discrimination_index, times_used, times_correct, avg_time_seconds
• 主题层次结构 --将问题组织成银行内部嵌套的主题
• 灵活的标签 --使用任意标签标记问题以进行跨领域分类
• 搜索和筛选 --按类型、难度范围、Bloom级别、主题、标签、状态或自由文本查询
• 批量激活 --在一次通话中将多个问题从草稿移动到活动状态
• AI建议 --在指定的难度和Bloom的级别上获取主题的问题想法
• 银行统计 --按类型、难度、布鲁姆水平和主题进行详细细分

快速开始

1.克隆并安装

git clone https://github.com/woodstocksoftware/question-bank-mcp.git
cd question-bank-mcp
python3.12 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2.配置克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "question-bank": {
      "command": "/path/to/question-bank-mcp/venv/bin/python",
      "args": ["/path/to/question-bank-mcp/run_server.py"]
    }
  }
}

然后重新启动Claude Desktop。

3.配置克劳德代码

claude mcp add question-bank /path/to/question-bank-mcp/venv/bin/python /path/to/question-bank-mcp/run_server.py

4.开始使用它

问克劳德这样的问题：

“为AP生物学创建题库” “添加细胞呼吸主题” “在分析级别创建一个关于克雷布斯循环的多项选择题” “显示所有标记为‘期中’的难题” “我的题库的统计数据是什么？”

工具参考

题库工具

create_question_bank

为课程或学科领域创建一个新的题库。

list_question_banks

列出所有题库及其问题和主题数量。没有参数。

get_bank_statistics

获取题库的详细统计数据，包括按问题类型、难度桶、布鲁姆级别和主题的细分。

主题工具

create_topic

添加一个主题来组织银行内的问题。通过以下方式支持分层嵌套 parent_topic_id.

list_topics

在题库中列出所有主题，并注明问题数量。

提问工具

create_question

创建一个包含完整元数据的新问题。问题开始于 draft 状态。

get_question

通过ID和所有元数据检索问题。

update_question

更新现有问题的任何字段，包括更改其状态。

delete_question

永久删除问题。

search_questions

使用多个条件在银行之间搜索和过滤问题。

activate_questions

批量激活问题，将其从 draft 到 active 状态。

suggest_questions

根据主题和限制，为要创建的新问题提供人工智能友好的建议。

资源

问题模式

领域

难度Buckets

布鲁姆分类水平

使用示例

建立数学题库

“为10-11年级创建一个名为‘代数2’的题库” “添加多项式、二次方程和指数函数的主题” “在应用级别创建3个关于分解多项式的多项选择题，难度0.4-0.6” “激活我们刚才创建的所有问题”

按难度和布鲁姆级别搜索

“查找评估或创建级别的所有难题” “搜索难度在0.7以上的关于二次曲线的问题” “显示所有标记为“期末考试”的草稿问题”

获取差距建议

“我的代数2库的统计数据是什么？” “建议5个关于指数增长的简单记忆级问题” “我们需要更多的分析级问题——为二次方程提出一些建议”

建筑

┌─────────────────────────────────────────────┐
│             Claude Desktop / Code            │
│               (MCP Client)                   │
└──────────────────┬──────────────────────────┘
                   │ stdio
┌──────────────────▼──────────────────────────┐
│  run_server.py                               │
│  └─ src/question_bank/server.py              │
│     ├─ 12 tools  (@mcp.tool)                │
│     ├─ 2 resources (@mcp.resource)           │
│     └─ Markdown-formatted responses          │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│  src/question_bank/database.py               │
│  ├─ question_banks     (top-level containers)│
│  ├─ topics             (hierarchical)        │
│  ├─ questions          (content + IRT)       │
│  ├─ question_topics    (many-to-many)        │
│  └─ question_tags      (many-to-many)        │
└──────────────────┬──────────────────────────┘
                   │
              data/question_bank.db (SQLite)

QTI 3.0兼容性

问题模式的设计如下 QTI 3.0 考虑兼容性。数据模型支持QTI导出所需的核心字段（问题类型、正确答案、选项、元数据），但导入/导出尚未实现。这是未来计划中的增强功能。

测试

目前还没有自动化测试套件。要验证数据库层是否正常工作，请执行以下操作：

python -m src.question_bank.database

要确认服务器启动，请执行以下操作：

python run_server.py

服务器在stdio传输上运行，因此它看起来会挂起（它正在等待MCP客户端输入）。按 Ctrl+C 停止。

贡献

欢迎投稿！该项目尚处于早期开发阶段。需要帮助的领域：

• 自动化测试（pytest）
• QTI 3.0导入/导出
• 其他问题类型
• CI/CD管道

许可证

麻省理工学院

______________________________________________________________________

由...建造 吉姆威廉斯 |