lexical-dictionary-data-fetcher
A backend service designed to systematically retrieve and structurally format linguistic assets from the Longman Dictionary repository for targeted lexical entries. It interfaces with the dictionary's web interface to acquire granular details, including definitions, contextual sentence usage, and etymological background, delivering this material uniformly as a JSON payload.
Author

edgardamasceno-dev
Quick Info
Actions
Tags
Automated Longman Lexical Resource Acquisition Service
This is a server utility, implemented utilizing Node.js and TypeScript, which targets the Longman Dictionary website to pull specific word data and serialize the scraped content into a prescribed JSON schema suitable for consumption by sophisticated Artificial Intelligence agents.
System Overview
The service establishes a connection to the official URL format https://www.ldoceonline.com/dictionary/<word>, systematically scrapes essential components such as introductory summaries, associated topical clusters, detailed entry sections (covering verbal and nominal forms), attested usage instances from the corpus, and the etymology. The resulting data structure adheres strictly to the Model Context Protocol (MCP) specifications, leveraging Axios for network operations and Cheerio for robust HTML parsing.
Core Functionality
- Comprehensive Longman Data Extraction:
- Retrieval of introductory texts and related thematic groupings.
- Detailed entry records, including phonetic representations, semantic definitions, and illustrative sentence examples.
- Collection of real-world examples sourced from the language corpus.
-
Identification and reporting of the word's historical derivation.
-
MCP Tool Exposition:
- Exposes its capabilities through the MCP SDK, ensuring seamless integration with MCP-compliant frontends, such as the Claude Desktop application.
Operational Prerequisites
- Runtime Environment: Node.js (Version 16 or newer recommended)
- Package Manager: npm
- Version Control: Git
Deployment Instructions
Automated Installation via Smithery
For automated setup tailored for Claude Desktop environments via Smithery, execute the following command:
bash npx -y @smithery/cli install @edgardamasceno-dev/ldoce-mcp-server --client claude
Manual Setup Procedure
- Obtain the source code repository: bash git clone https://github.com/seuusuario/ldoce-mcp-server.git cd ldoce-mcp-server
