find_concordances
Locate word contexts within documents from the National Library of Norway's digital collections to analyze usage patterns and textual occurrences.
Instructions
Find concordances (contexts) for a word in a specific document.
Args: urn: URN identifier for the document word: Word to find concordances for window: Number of words before and after the match (default: 25) limit: Maximum number of concordances to return (default: 100)
Returns: JSON string containing concordance results
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urn | Yes | ||
| word | Yes | ||
| window | No | ||
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/dhlab_mcp/server.py:88-119 (handler)Handler function decorated with @mcp.tool(), implementing the logic to find concordances for a word in a document using dhlab.Corpus.conc method. Handles input parameters, performs the query, and returns JSON results or error messages.
def find_concordances( urn: str, word: str, window: int = 25, limit: int = 100, ) -> str: """Find concordances (contexts) for a word in a specific document. Args: urn: URN identifier for the document word: Word to find concordances for window: Number of words before and after the match (default: 25) limit: Maximum number of concordances to return (default: 100) Returns: JSON string containing concordance results """ try: # Create corpus from URN corpus = dhlab.Corpus.from_identifiers([urn]) if len(corpus.corpus) == 0: return f"No document found for URN: {urn}" # Get concordances using corpus method concs = corpus.conc(words=word, window=window, limit=limit) if concs.concordance is not None and len(concs.concordance) > 0: return concs.concordance.to_json(orient='records', force_ascii=False) return "No concordances found" except Exception as e: return f"Error finding concordances: {str(e)}"