AI · 源文件

---
title: "MCP Server - Hyper-Extract"
source_url: "https://yifanfeng97.github.io/Hyper-Extract/latest/mcp/"
source_site: "yifanfeng97.github.io"
clipped_at: "2026-07-10T11:45:40.883812+00:00"
clipper: "aiwiki-url-ingest"
extractor: "readability_rendered"
source_strategy: "normal_web_clip"
source_strategy_label: "普通网页抓取"
---

# MCP Server

Hyper\-Extract ships an [MCP](https://modelcontextprotocol.io) server so MCP\-capable assistants (Claude Desktop, IDE agents, etc.) can **query and export your Knowledge Abstracts** over the Model Context Protocol.

It is **read \+ export only** — it never creates, mutates, or deletes a KA.

---

## Install \& Run

```
pip install 'hyperextract[mcp]'

# start the server (stdio transport)
he-mcp
# equivalent:
python -m hyperextract.mcp_server

```

The server reads your LLM/embedder configuration from `~/.he/config.toml` — the same config the CLI uses, so run `he config init ...` first (see [Configuration](../cli/configuration/)).

---

## Connect it to an MCP client

Point your MCP client at the `he-mcp` command. For a Claude Desktop–style config:

```
{
 "mcpServers": {
 "hyper-extract": {
 "command": "he-mcp"
 }
 }
}

```

---

All tools take a `ka_path` (a directory created by `he parse`). `search`/`ask` require an index — build it with [`he build-index`](../cli/commands/build-index/).

> `export_obsidian` requires the Obsidian export feature (see [`he export obsidian`](../cli/commands/export/)). If it is unavailable, the tool returns an explanatory message instead of failing.

---

## Example session

```
list_templates() → [{name: "general/biography_graph", ...}, ...]
info(ka_path="./tesla_kb") → {nodes: 48, edges: 70, index_built: true, ...}
search(ka_path="./tesla_kb",
 query="War of Currents") → {nodes: [...], edges: [...]}
ask(ka_path="./tesla_kb",
 question="Who were Tesla's rivals?") → "Thomas Edison ..."
export_obsidian(ka_path="./tesla_kb",
 output="./vault") → "Exported 49 notes to ./vault"

```