Skip to main content
Glama
edgardamasceno-dev

Longman Dictionary MCP Server

README.md
# Ldoce MCP Server
[![smithery badge](https://smithery.ai/badge/@edgardamasceno-dev/ldoce-mcp-server)](https://smithery.ai/server/@edgardamasceno-dev/ldoce-mcp-server)


Este é um MCP server desenvolvido em Node.js e TypeScript que consome a página do Longman Dictionary para uma determinada palavra e retorna os dados extraídos no formato JSON padronizado para uso por agentes de IA.

## Descrição

O servidor se conecta à URL `https://www.ldoceonline.com/dictionary/<word>`, extrai informações como a introdução, tópicos relacionados, entradas (verb e noun), corpus examples e origem, e retorna esses dados estruturados em um objeto JSON. O projeto segue os padrões do Model Context Protocol (MCP) e utiliza os pacotes Axios e Cheerio para requisições HTTP e parsing de HTML.

## Recursos

- **Extrai informações do Longman Dictionary:**
  - Introdução e tópicos relacionados
  - Entradas com detalhes de pronúncias, sentidos, exemplos, etc.
  - Corpus examples
  - Origem da palavra

- **Utiliza MCP SDK para expor uma ferramenta** que pode ser integrada a clientes MCP, como o Claude Desktop.

## Pré-requisitos

- Node.js (versão 16 ou superior)
- npm
- Git

## Instalação

### Installing via Smithery

To install Ldoce Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@edgardamasceno-dev/ldoce-mcp-server):

```bash
npx -y @smithery/cli install @edgardamasceno-dev/ldoce-mcp-server --client claude
```

### Manual Installation
1. Clone o repositório:
   ```bash
   git clone https://github.com/seuusuario/ldoce-mcp-server.git
   cd ldoce-mcp-server

TDQS

B3.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as fetching and parsing dictionary entries from Longman.

Naming Consistency5/5

Since there is only a single tool, naming consistency is inherently perfect. The tool name 'get_dictionary_entry' follows a clear verb_noun pattern, which would be consistent if more tools were added.

Tool Count2/5

A single tool is too few for a dictionary server, as it lacks basic operations like searching for words, handling synonyms/antonyms, or managing user history. This minimal scope limits functionality and feels incomplete for the domain.

Completeness2/5

The tool surface is severely incomplete for a dictionary server. While it provides entry retrieval, it misses essential features such as word search, phonetic lookups, example sentences, or related terms, which are standard in dictionary applications.

Maintenance

ActivityInactive
ResponsivenessNo issues