convez.ai
MCP ServerAutomaçãoAvançado
loLollipop

Engineering Research MCP

loLollipop/research-mcp-aggregator

Ecosistema MCP completo para workflows de pesquisa em engenharia

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP local que centraliza ferramentas de pesquisa em engenharia: busca de papers (arXiv, Semantic Scholar, OpenAlex), extração de PDFs com MinerU, gerenciamento de referências (Zotero), integração com simuladores (COMSOL, Fluent, MATLAB, Origin), e suporte a escrita científica (LaTeX, BibTeX, Word).

Instalação

$npx convez-ai loLollipop/research-mcp-aggregator

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
16
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar buscas literárias e gerenciamento de referências bibliográficas
  • Orquestrar simulações numéricas (COMSOL, ANSYS Fluent, MATLAB) e parsear resultados
  • Extrair e processar dados de PDFs científicos com conversão para Markdown
  • Gerar figuras e gráficos (Matplotlib, OriginLab) a partir de dados de simulação
  • Compilar e validar documentos LaTeX com integração BibTeX
  • Manter memória local persistente de notas, experiências e feedback para RAG

Veredito

Ferramenta robusta e especializada para pesquisadores em engenharia que trabalham com simulação numérica e documentação científica. Requer integração com múltiplos softwares proprietários (COMSOL, Fluent, Origin) e conhecimento técnico avançado; ideal para laboratórios já equipados com esses ambientes.

README

A tradução para o português deste README ainda está na fila.

Engineering Research MCP

One local MCP server for engineering research workflows.

Search papers, parse PDFs, manage Zotero records, drive local simulation software, plot results, and prepare manuscript assets from a single MCP endpoint.

English | 简体中文


What it does

research-mcp brings common engineering research workflow tools into one local server.

AreaBuilt-in capability
LiteraturearXiv, Semantic Scholar, OpenAlex, Zotero Web API
Memory / RAGLocal SQLite long-term memory for reusable notes, simulation experience, literature notes, web-source drafts, and feedback-aware retrieval
PDF readingMinerU extraction to Markdown, page text, headings, tables, formulas, captions
SimulationCOMSOL, Fluent, PFC, MATLAB planning, batch fallbacks, live adapters, result parsers
WritingBibTeX helpers, LaTeX compile/validation, Word/docx editing
FiguresMatplotlib SVG/PNG/PDF plots from arrays or CSV columns
OriginLabWindows Origin/OriginPro worksheet import, graph creation, styling, image export, and LabTalk escape hatch
PlanningLiterature-review, simulation-study, paper-asset, and Nature-style plans

Configure research-mcp once, then call tools directly such as arxiv_search, pdf_extract_mineru, zotero_add_by_doi, memory_search, comsol_parse_table, matlab_run_file, origin_create_plot, plot_xy, latex_compile, or docx_create.

Simulation philosophy

The simulation tools are an assistant-facing control surface for installed local solvers, not a replacement for COMSOL, ANSYS Fluent, PFC, or expert validation. They help MCP clients and AI coding assistants inspect files, preflight batch commands with dry_run, drive native solver APIs or bridge sessions, parse exported tables/logs, and organize reproducible numerical-study artifacts.

Model setup, units, materials, boundary conditions, mesh or timestep sensitivity, solver convergence, and final physical interpretation remain in the native solver and researcher review loop.


Install

Requirements: Python 3.10-3.12 and uv.

git clone https://github.com/loLollipop/research-mcp-aggregator.git
cd research-mcp-aggregator
uv venv
uv pip install -e .

Optional extras:

uv pip install -e ".[all]"      # all optional non-dev integrations
uv pip install -e ".[dev]"      # test/lint/build tools
uv pip install -e ".[comsol]"   # COMSOL MPh backend
uv pip install -e ".[fluent]"   # PyFluent backend
uv pip install -e ".[pfc]"      # PFC bridge websocket client
uv pip install -e ".[origin]"   # OriginLab Origin/OriginPro automation on Windows

Start the server:

research-mcp
# or
python -m research_mcp.server

MCP client config

Minimal installed-package config:

{
  "mcpServers": {
    "research-mcp": {
      "command": "research-mcp",
      "type": "stdio"
    }
  }
}

Development checkout config:

{
  "mcpServers": {
    "research-mcp": {
      "command": "python",
      "args": ["-m", "research_mcp.server"],
      "type": "stdio",
      "env": {
        "PYTHONPATH": "D:/path/to/research-mcp-aggregator/src",
        "MINERU_API_TOKEN": "your-mineru-token",
        "ZOTERO_API_KEY": "your-zotero-key",
        "ZOTERO_LIBRARY_ID": "your-library-id",
        "ZOTERO_LIBRARY_TYPE": "user",
        "RESEARCH_MCP_MEMORY_DB": "D:/path/to/research-memory.sqlite3",
        "COMSOL_CMD": "comsol",
        "FLUENT_CMD": "fluent",
        "PFC_CMD": "pfc",
        "MATLAB_CMD": "matlab",
        "ORIGIN_EXE": "D:/software/origin/Origin64.exe",
        "ORIGIN_VISIBLE": "1",
        "LATEX_CMD": "latexmk"
      }
    }
  }
}

Only set the environment variables for workflows you actually use.


Tool map

GroupTools
Workflowsresearch_capability_list, research_literature_review_plan, research_simulation_study_plan, research_paper_asset_pack
Migration catalogexternal_mcp_list, external_mcp_get, external_mcp_config_snippet, engineering_workflow_template
Memory / RAGmemory_status, memory_record, memory_search, memory_export_context, memory_record_simulation_run, memory_record_error_case, memory_record_literature_note, memory_index_zotero_item, memory_record_web_source, memory_record_web_results, memory_feedback, memory_promote, memory_deprecate
Literature APIsarxiv_*, s2_*, openalex_*
PDF / MinerUpdf_check_config, pdf_extract_mineru
Zoterozotero_status, zotero_search_items, zotero_get_item, zotero_create_collection, zotero_add_by_doi, zotero_update_item_tags
Simulationsimulation_check_config, simulation_workflow_template, comsol_*, fluent_*, pfc_*
MATLABmatlab_check_config, matlab_create_script, matlab_check_code, matlab_evaluate_code, matlab_run_file, matlab_run_test_file, matlab_detect_toolboxes, matlab_parse_table, matlab_create_plot_export_script
OriginLaborigin_check_config, origin_get_info, origin_new_project, origin_open_project, origin_save_project, origin_import_csv, origin_list_worksheets, origin_create_plot, origin_apply_publication_style, origin_export_graph, origin_execute_labtalk, origin_release
PFC docspfc_docs_status, pfc_browse_commands, pfc_query_command, pfc_browse_python_api, pfc_query_python_api
Figuresplot_xy, plot_csv_columns
Writingformat_bibtex, generate_citation_key, parse_bibtex
Manuscriptslatex_*, docx_*, nature_*

Configuration notes

MinerU PDF extraction

export MINERU_API_TOKEN="..."

pdf_extract_mineru uploads a local PDF to MinerU, downloads the result archive, and writes:

  • outputs/mineru/<paper>/raw/
  • outputs/mineru/<paper>/pages/page_*.txt
  • outputs/mineru/<paper>/manifest.json
  • optionally outputs/pdf_pages/page_*.txt and paper_sections_extract.txt

Use ocr=true for scanned PDFs and page_ranges="8-19" for partial extraction.

Zotero

export ZOTERO_API_KEY="..."
export ZOTERO_LIBRARY_ID="..."
export ZOTERO_LIBRARY_TYPE="user"  # or group

Zotero write tools modify the configured library.

COMSOL / Fluent / PFC

export COMSOL_CMD="/path/to/comsol"
export FLUENT_CMD="/path/to/fluent"
export PFC_CMD="/path/to/pfc"
export SIM_TIMEOUT_SECONDS="3600"

Stable simulation utilities include planning, file inspection, exported-table parsing, and plotting. Live solver sessions depend on local commercial software, licenses, and machine state. Batch tools such as comsol_run_batch, fluent_run_journal, and pfc_run_script support dry_run=true so an assistant can review resolved commands before spending license time or modifying solver state.

For PFC GUI bridge workflows, the bridge must be started inside the GUI process. research-mcp cannot auto-inject it into PFC. If pfc_bridge_status or a bridge-backed PFC tool finds no bridge, it writes a helper script to outputs/pfc_bridge/start_pfc_bridge.py and returns the exact console command to paste into the PFC GUI Python console. The minimal manual command is:

import pfc_mcp_bridge

pfc_mcp_bridge.start()

MATLAB

export MATLAB_CMD="/path/to/matlab"
export MATLAB_TIMEOUT_SECONDS="600"

The MATLAB adapter is self-contained in Python and uses MATLAB command-line -batch workflows for code checking, code evaluation, file execution, test-file execution, and toolbox detection. Execution tools default to dry_run=true so commands can be reviewed before consuming license time or running generated code. It also includes local parsing of MATLAB-exported CSV/TSV/TXT tables and generation of MATLAB plot-export scripts for reviewed post-processing workflows.

Minimal local smoke check, if MATLAB is installed and licensed:

matlab -batch "disp('research-mcp MATLAB smoke')"
python -m pytest -q tests/test_matlab_adapter.py

The automated test suite uses dry-run and pure-Python paths by default, so it can run on GitHub Actions without a MATLAB installation. Live MATLAB execution should be treated as an optional local validation step before releases.

For release checks, maintainers can run a fuller local smoke that exercises code evaluation, file execution, checkcode, runtests, toolbox detection, MATLAB-exported table parsing, and plot-export script generation. Keep generated artifacts under outputs/, which is ignored by git.


Maturity

LevelMeaning
Stable localdeterministic file, parser, plotting, BibTeX, LaTeX, docx, and exported-table utilities
Stable API-backedarXiv, OpenAlex, Semantic Scholar, Zotero, and MinerU workflows with normal network/API caveats
Experimental live desktop/solverCOMSOL MPh, PyFluent, PFC bridge, MATLAB, and OriginLab control requiring local installs and licenses
Catalog helperscapability discovery and workflow-template utilities

Development

uv venv
uv pip install -e ".[all,dev]"
python -m pytest -q
python -m ruff check .
python -m build

Optional PFC documentation browsing uses locally available documentation assets when present in development checkouts.


Friendly links


Limitations

  • Live COMSOL, Fluent, and PFC control is experimental and not a substitute for vendor-side validation.
  • MATLAB command-line execution is experimental and requires a local MATLAB installation and license.
  • OriginLab automation is Windows-only, requires a licensed local Origin/OriginPro installation, and is not a substitute for manual figure review.
  • Public scholarly APIs can be rate-limited or return incomplete metadata.
  • MinerU parsing uploads PDFs to the configured MinerU service; use it only for files you are allowed to process externally.
  • Public beta tool schemas may change before a stable release.

License

MIT.

Ver o original no GitHub

Bom para

Relacionados