gitwtfhub

wtf is armenian-national-library-mcp?

suren-kk/armenian-national-library-mcp — explained in plain English

Analysis updated 2026-05-18

4TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

An MCP server that lets AI assistants search and read metadata from the National Library of Armenia's public catalogue, unofficial and read-only.

Mindmap

mindmap
  root((nla mcp server))
    What it does
      Search library catalogue
      Read item metadata
      Bounded text extraction
      Provide file links
    Tech stack
      TypeScript
      Node.js
      MCP protocol
      DSpace repository
    Use cases
      Research assistants
      Multilingual search
      Rights aware lookups
    Audience
      Developers
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Ask an AI assistant to search the Armenian National Library catalogue for works by a specific author.

REASON 2

Retrieve structured metadata, rights status, and download links for a library item without leaving your AI chat client.

REASON 3

Read bounded chunks of extracted text from a public library item directly inside an AI assistant.

What's in the stack?

TypeScriptNode.jsMCP SDKDSpace

How it stacks up

suren-kk/armenian-national-library-mcp0labs-in/vision-linkalfons-fhl/cursor-plan2api
Stars444
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Node.js 24 and connecting it to an MCP-compatible client such as Claude Code or Codex.

The project's own code is MIT licensed, but library metadata and content are separately rights-restricted and not covered by that license.

Wtf does this do

This project is an unofficial MCP server that connects AI assistants like Claude Code or Codex to the public catalogue of the National Library of Armenia. MCP stands for Model Context Protocol, a way for AI tools to call external services as structured tools rather than guessing at answers. It is not run or endorsed by the library itself, it simply reads from the library's already-public online repository. Once connected, an assistant can search the library's catalogue for books, periodicals, and manuscripts in Armenian, English, or Russian, filter results by author, subject, year, language, or collection, and look up full metadata for a specific item, including its rights and access status. When a public text version of an item exists, the assistant can read it in bounded chunks, and it can also provide a direct link to an original file on the library's own site so a user never needs the file placed inside the AI's context window. The server is careful about what it claims. Every response includes structured fields showing the data returned, where it came from, any warnings, and whether the result was cut short. It tracks whether an item's rights status is known or unknown, but it never decides on its own whether reusing a file is actually permitted, since public access and legal reuse rights are treated as separate questions. The project is built in TypeScript on Node.js and can run as a local command-line process using standard input and output, or as a stateless web server that other tools connect to remotely. It ships as an npm package, so a user installs it with a single command and adds it to their AI client's configuration, after which the assistant gains a defined set of catalogue-searching tools and stops needing to browse the library's website manually.

Yoink these prompts

Prompt 1
Install this MCP server in Claude Code and connect it using the stdio transport command from the README.
Prompt 2
Search the Armenian National Library catalogue for works by Hovhannes Tumanyan and show me the three most relevant records.
Prompt 3
Explain how this MCP server distinguishes between public access and content reuse rights for a library item.
Prompt 4
Set up the stateless HTTP transport for this server and describe how to secure it with allowed hosts and origins.
Prompt 5
Use the get_search_facets tool to narrow a broad catalogue search by year and language.

Frequently asked questions

wtf is armenian-national-library-mcp?

An MCP server that lets AI assistants search and read metadata from the National Library of Armenia's public catalogue, unofficial and read-only.

What language is armenian-national-library-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP SDK.

What license does armenian-national-library-mcp use?

The project's own code is MIT licensed, but library metadata and content are separately rights-restricted and not covered by that license.

How hard is armenian-national-library-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is armenian-national-library-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.