科研管理大模型原型系统 - 课题管理 MCP Server Demo

本项目是“科研管理大模型原型系统”中“课题管理智能体模块”的本地 MCP Server Demo。它面向本地展示和后续平台接入，优先跑通文档导入、结构化抽取、课题档案管理、人员/进度/资金管理、报表生成和 MCP 工具调用闭环。

功能范围

已覆盖：

• 2.2.1 文档信息自动提取与管理。

• 2.2.2 课题过程自动化管理。

• 2.2.4 报表与总结自动生成。

暂不完整实现：

• 复杂课题风险预警系统。

• 生产级权限系统。

• 复杂前端。

• 完整知识图谱。

• 科研布局和成果管理模块。

• 强制 LLM 抽取。

Related MCP server: scholar-toolkit-mcp

已实现功能

• DOCX/PDF/TXT/MD/XLSX/XLS/CSV 解析入口，其中当前样例重点验证 DOCX。

• 文档分类：立项签报、采购签报、绩效发放签报、阶段报告、课题统计报表、未知。

• 规则抽取：课题名称、负责人、部门、起止时间、预算、绩效、成员、进度、阶段内容等。

• 抽取 evidence 保留。

• SQLite 本地档案库。

• 文档版本、hash、导入时间记录。

• 人员、里程碑、资金、采购、绩效、阶段成果、操作日志表。

• Markdown 报表和阶段总结。

• Excel 多 Sheet 报表导出。

• FastAPI 本地接口。

• FastMCP 工具集。

• 本地路径和 HTTP/HTTPS 文件 URL 导入入口。

• 知识库输入文本落地目录。

• Dockerfile。

• 基础测试用例。

项目结构

app/
  main.py
  mcp_server.py
  config.py
  database.py
  models.py
  schemas.py
  document_parser.py
  document_classifier.py
  extractor.py
  services/
  tools/
  utils/
data/
  demo.db
  uploads/
  reports/
  knowledge_base_inputs/
docs/
scripts/
tests/
requirements.txt
Dockerfile

安装依赖

python -m pip install -r requirements.txt

初始化数据库

python scripts/init_db.py

导入样例文件

python scripts/ingest_samples.py

本地运行 Demo

python scripts/run_demo.py

运行 FastAPI

python -m uvicorn app.main:app --reload --port 8000

接口：

• /health

• /demo

• /projects

• /projects/{project_id}

• /reports

• /docs

运行 MCP Server

python app/mcp_server.py

默认 SSE 地址：

http://127.0.0.1:8001/sse

平台接入时，远程 URL、鉴权、上传文件参数形态仍需按 docs/UNKNOWN_ITEMS.md 确认。

PostgreSQL 可通过环境变量切换：

set RPM_DATABASE_URL=postgresql+psycopg://user:password@host:5432/dbname

Docker

docker build -t research-project-mcp-demo .
docker run --rm -p 8001:8001 -v %cd%/data:/app/data research-project-mcp-demo

MCP 工具清单

• ingest_project_documents

• ingest_project_documents_text

• get_extraction_result

• confirm_project_data

• query_project

• list_projects

• update_project_progress

• get_project_fund_summary

• generate_project_report

• save_researcher_profile_page

• save_duplicate_check_report_page

• search_project_documents

• get_operation_logs

save_researcher_profile_page 用于保存科研人员画像 HTML，并返回可在浏览器打开的 /profile-pages/{filename} 页面链接。save_duplicate_check_report_page 用于保存查重智能体生成的论文查重分析报告 HTML。两类页面链接都复用 RPM_DOWNLOAD_BASE_URL 对应的 FastAPI 外部访问地址。

数据库表

• project_info

• project_document

• project_member

• project_milestone

• project_fund

• project_purchase

• project_performance

• project_stage_result

• operation_log

平台接入说明

本地 Demo 当前优先采用 FastMCP SSE。平台手册和截图显示灵犀支持远程 MCP、容器化 MCP、API 转 MCP 三种方式。建议优先确认远程 MCP 的协议和 URL 要求，再接入：

http://<可被平台访问的主机>:8001/sse

如平台只能接 OpenAPI，可临时使用 FastAPI 的 /docs 或 /openapi.json 做 API 转 MCP 备选。

待确认问题

详见：

• docs/UNKNOWN_ITEMS.md

重点包括平台协议、文件上传参数形态、容器持久化、模型 API、PostgreSQL 要求、报表格式和验收边界。