{
  "markdown": "# datamuse-mcp\n\n[![npm version](https://img.shields.io/npm/v/datamuse-mcp?style=flat&logo=npm)](https://www.npmjs.com/package/datamuse-mcp)\n[![npm downloads](https://img.shields.io/npm/dt/datamuse-mcp?style=flat&logo=npm)](https://www.npmjs.com/package/datamuse-mcp)\n[![license](https://img.shields.io/npm/l/datamuse-mcp?style=flat)](./LICENSE)\n[![node](https://img.shields.io/node/v/datamuse-mcp?style=flat&logo=node.js)](https://www.npmjs.com/package/datamuse-mcp)\n[![github release](https://img.shields.io/github/v/release/lacausecrypto/datamuse-mcp?style=flat&logo=github)](https://github.com/lacausecrypto/datamuse-mcp/releases)\n[![publish workflow](https://img.shields.io/github/actions/workflow/status/lacausecrypto/datamuse-mcp/publish.yml?style=flat&logo=githubactions&label=publish)](https://github.com/lacausecrypto/datamuse-mcp/actions/workflows/publish.yml)\n\nMCP server for the Datamuse API (word search, rhymes, synonyms, and more).\n\nThis project is open source, free to use, and licensed under MIT.\n\n## About\n\n`datamuse-mcp` is a local stdio MCP server that wraps Datamuse endpoints into validated MCP tools.\nIt is designed for practical word-finding use cases in assistants and clients that support MCP.\n\n## Purpose\n\nThis server provides simple MCP tools to:\n\n- find synonyms, antonyms, and rhymes;\n- run autocomplete;\n- fetch lexical details (definitions, POS, syllables, pronunciation, frequency);\n- search by spelling pattern (`*`, `?`) or phonetic similarity.\n\n## Requirements\n\n- Node.js `>= 18`\n- npm\n\n## Install\n\n```bash\nnpm install\n```\n\n## Development\n\n```bash\nnpm run dev\n```\n\n## Build & run\n\n```bash\nnpm run build\nnpm start\n```\n\n## Manual JSON-RPC checks\n\n```bash\n# List tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node dist/index.js\n\n# Call a tool\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"find_synonyms\",\"arguments\":{\"word\":\"happy\"}}}' | node dist/index.js\n```\n\n## More tool examples\n\n```json\n{ \"tool\": \"find_antonyms\", \"arguments\": { \"word\": \"happy\", \"max\": 10 } }\n{ \"tool\": \"find_rhymes\", \"arguments\": { \"word\": \"love\", \"type\": \"perfect\", \"max\": 20 } }\n{ \"tool\": \"find_similar_sounding\", \"arguments\": { \"text\": \"definately\", \"max\": 15 } }\n{ \"tool\": \"find_by_pattern\", \"arguments\": { \"pattern\": \"s??r?\", \"meaning_hint\": \"celestial\", \"max\": 25 } }\n{ \"tool\": \"find_related_words\", \"arguments\": { \"word\": \"music\", \"relation_type\": \"triggers\", \"max\": 15 } }\n{ \"tool\": \"get_word_info\", \"arguments\": { \"word\": \"serendipity\" } }\n{ \"tool\": \"autocomplete\", \"arguments\": { \"prefix\": \"astro\", \"max\": 10 } }\n```\n\n## Claude Desktop configuration\n\nAdd this to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"datamuse\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/datamuse-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Exposed tools\n\n- `find_synonyms`\n- `find_antonyms`\n- `find_rhymes`\n- `find_similar_sounding`\n- `find_by_pattern`\n- `find_related_words`\n- `find_adjectives_for_noun`\n- `find_nouns_for_adjective`\n- `get_word_info`\n- `autocomplete`\n\n## Security and limits\n\n- The server runs over `stdio` (local usage recommended).\n- Outbound requests go to `https://api.datamuse.com`.\n- A local in-memory cache is used (5-minute TTL), with no disk persistence.\n- Datamuse may enforce request limits/quotas.\n\n## Publishing\n\nFor npm and MCP Registry deployment, see [PUBLISHING.md](./PUBLISHING.md).\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n",
  "bytes": 3489,
  "sha": "2608cabe1b0f2b2c3d592e41be628b13d023c36977bea082970eb58143e0d157",
  "repo_slug": "lacausecrypto/datamuse-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lacausecrypto_datamuse_mcp_bb824731/readme"
}