Skip to content

mideind/icelandic-morphology-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Icelandic Morphology MCP Server

An MCP (Model Context Protocol) server that provides Icelandic word inflection lookups using BinPackage.

This server enables LLMs to query the Database of Icelandic Morphology (BÍN) to answer questions about Icelandic word inflections, such as:

  • "Hvernig beygist orðið hestur?" (How does the word hestur inflect?)
  • "Hvað er þágufall fleirtölu af kona?" (What is the dative plural of kona?)
  • "Er síamskattarkjóll rétt orð?" (Is síamskattarkjóll a correct word?)

Installation

pip install icelandic-morphology-mcp

Or install from source:

git clone https://github.com/mideind/icelandic-morphology-mcp
cd icelandic-morphology-mcp
pip install -e .

Tools

The server exposes three tools:

lookup_word

Look up an Icelandic word form and return all matching entries.

lookup_word("færi")
# Returns all interpretations: verb forms of "fara", "færa", noun "færi", etc.

get_variant

Get a specific grammatical variant of a word.

get_variant("hestur", "kk", ["ÞGF", "FT"])
# Returns: "hestum" (dative plural)

get_variant("fallegur", "lo", ["EVB", "KVK"])
# Returns: "fallegasta" (superlative weak, feminine)

get_lemma

Find the lemma(s) and word class(es) for a word form.

get_lemma("hestana")
# Returns: [{"lemma": "hestur", "word_class": "kk"}]

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "icelandic-morphology": {
      "command": "icelandic-morphology-mcp"
    }
  }
}

Or if running from source:

{
  "mcpServers": {
    "icelandic-morphology": {
      "command": "python",
      "args": ["-m", "icelandic_mcp.server"],
      "cwd": "/path/to/icelandic-morphology-mcp"
    }
  }
}

Grammatical Tags

The server uses standard BÍN grammatical tags:

Tag Meaning
NF, ÞF, ÞGF, EF Cases: nominative, accusative, dative, genitive
ET, FT Number: singular, plural
gr, nogr Article: definite, indefinite
kk, kvk, hk Gender: masculine, feminine, neuter
so, lo, no Class: verb, adjective, noun
FSB, FVB, MST, ESB, EVB Adjective degree/form
GM, MM Voice: active, middle
FH, VH, NH Mood: indicative, subjunctive, infinitive
NT, ÞT Tense: present, past
1P, 2P, 3P Person: 1st, 2nd, 3rd

For full documentation, see BÍN tagset.

License

MIT License. See LICENSE for details.

The underlying BÍN data is licensed under CC BY-SA 4.0 by The Árni Magnússon Institute for Icelandic Studies.

Credits

About

MCP server for Icelandic word inflection lookups using BinPackage (islenska)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages