Academic Research Kernel MCP server

academic-research-kernel

<!-- mcp-name: io.github.xngg1021/academic-research-kernel -->

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Português · Русский · Bahasa Indonesia · Italiano · हिन्दी · العربية · বাংলা · اردو · Tiếng Việt · Türkçe · فارسی · Kiswahili · Polski

Harness-neutral deterministic research-state kernel for agentic research workflows. It unifies research object identity, empirical evidence receipts, tripartite claim-evidence graphs (CEG), and append-only research decision logs through a deterministic ingestion bridge and universal Model Context Protocol (MCP) server. 13 specialized scholarly skills act as producers and consumers of verified research state, with native support for Claude Code, Cursor, Codex, Gemini CLI, and Hermes Agent. Validation scope and external-service limitations are recorded in the audit.

Author: Junfu Shi (SJF, xngg1021), Hermes Agent. Current scoped offer: Source Lineage License 1.0.

Quick start

After 2.0.0 is published to PyPI, run with uv:

uvx academic-research-kernel mcp

Publication is a separate release step: check the 2.0.0 release manifest for the actual PyPI status. Before publication, download the release wheel and use uvx --from ./academicresearchkernel-2.0.0-py3-none-any.whl academic-research-kernel mcp. For a fixed product identity, use uvx academic-research-kernel@2.0.0 mcp. Python 3.10–3.14 is supported; uvx --python 3.12 explicitly selects a supported interpreter. All 12 deterministic tools, including statistics, are included in the base install.

Verify

uvx academic-research-kernel doctor
uvx academic-research-kernel --version

The offline diagnostic checks dependencies, schemas and all 12 tool definitions. Optional services can remain unconfigured. Use doctor --json for machine-readable output.

Package install

uv tool install academic-research-kernel==2.0.0
academic-research-kernel doctor
academic-research-kernel mcp

Alternatively, install with pipx install academic-research-kernel==2.0.0 or python -m pip install academic-research-kernel==2.0.0 inside a supported virtual environment. [full] adds libraries for extended scientific skill examples; [qa] adds repository validation tools. GPU backends and paid services remain optional.

Hermes

Install uv so it is on Hermes' process PATH, then install and explicitly enable the portable plugin:

hermes plugins install xngg1021/academic-research-kernel --no-enable
hermes plugins enable academic-skills

The existing academic-skills identity and all 13 skills are preserved. The plugin's mcp.json invokes uv run --frozen --no-dev --no-editable with Python 3.12 and the checkout's uv.lock; its environment lives under ${PLUGIN_DATA}/runtime. It bootstraps dependencies on first use, without borrowing Hermes' or the system's Python packages. First use needs network access to obtain missing packages/interpreter. The older skill-only tap remains supported under Integration & Portable Usage.

From source

git clone https://github.com/xngg1021/academic-research-kernel.git
cd academic-research-kernel
uv sync --frozen --no-dev --no-editable
uv run --frozen --no-dev --no-editable academic-research-kernel doctor
uv run --frozen --no-dev --no-editable python scripts/mcp_server.py

Shortened. The full README is on GitHub.