ladon-nous 0.1.0

MCP server exposing Ladon crawl data to AI agents (Claude Desktop, Cursor, etc.).

ladon-nous

MCP server exposing Ladon crawl data to AI agents.

ladon-nous (νοῦς — the Greek principle of divine intellect) is the mind interface of the Ladon crawler framework. It serves crawled data from a DuckDB database over the Model Context Protocol (MCP), making it available to Claude Desktop, Cursor, and other MCP-compatible AI clients.

---

What it does

Point ladon-nous at a DuckDB file produced by a Ladon adapter (e.g. ladon-mimir), and your AI client can instantly:

• Search articles by keyword across title, summary, and full text
• List crawl runs and check their status
• Read full article content as a resource

---

Tools

Tool	Description
article_search(query, limit=10)	Keyword search across crawled articles
run_list(limit=20)	Recent crawl runs with status and article counts
crawl_status(run_id)	Status detail for a specific run

Resources

Resource	Description
ladon://articles/{page_id}	Full Markdown content of a single article

---

Installation

pip install ladon-nous

Or for development:

git clone https://github.com/MoonyFringers/ladon-nous
cd ladon-nous
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

---

Usage

ladon-nous serve --db /path/to/mimir.db

The server speaks MCP over stdio by default (compatible with Claude Desktop). Add --transport sse for HTTP/SSE deployment.

---

Claude Desktop setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ladon-nous": {
      "command": "/path/to/.venv/bin/ladon-nous",
      "args": ["serve", "--db", "/path/to/mimir.db"]
    }
  }
}

Restart Claude Desktop. The article_search, run_list, and crawl_status tools will appear automatically.

---

Compatibility

ladon-nous v0.1.0 is designed for databases produced by ladon-mimir (Wikipedia adapter). Support for other Ladon adapters will be added in v0.2.0 via the LadonMCPAdapter plugin protocol.

---

License

Apache-2.0. See LICENSE.