Packages
HexDocs MCP is a project that provides semantic search capabilities for Hex package documentation, designed specifically for AI applications. It downloads, processes, and generates embeddings from Hex package documentation and provides a Model Context Protocol (MCP) server for searching.
Current section
Files
Jump to
Current section
Files
hexdocs_mcp
CHANGELOG.md
CHANGELOG.md
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [0.1.2]
### Changed
- Simplified installation process - now installable via npx
- Updated MCP server response format to match latest MCP standard
### Removed
- Removed `list_packages` tool from MCP server
## [0.1.1] - 2024-04-04
### Changed
- Published NPM package to align version with Hex package
## [0.1.0] - 2024-04-03
Initial release of HexDocs MCP, providing semantic search capabilities for Hex package documentation.
### Added
#### Elixir Package
- `mix hex.docs.mcp fetch` command to:
- Download Hex package documentation
- Convert HTML docs to consolidated markdown
- Create semantic text chunks
- Generate embeddings using Ollama
- Automatically initialize SQLite database with vector search capabilities when needed
- `mix hex.docs.mcp search` command for semantic search in embeddings
- Support for custom embedding models via `--model` flag
- Configurable data storage location via `HEXDOCS_MCP_PATH` environment variable
#### TypeScript MCP Server
- Model Context Protocol (MCP) server implementation
- Integration with MCP-compatible clients (Cursor, Claude Desktop App, etc.)
- Vector similarity search using SQLite database
- Automatic database initialization on startup
### Dependencies
- Requires Elixir 1.16 or later
- Requires Node.js 22 or later
- Requires Ollama for embedding generation
- Default model: `nomic-embed-text`
- Support for alternative models like `all-minilm`
[Unreleased]: https://github.com/bradleygolden/hexdocs-mcp/compare/v0.1.2...HEAD
[0.1.2]: https://github.com/bradleygolden/hexdocs-mcp/releases/tag/v0.1.2
[0.1.1]: https://github.com/bradleygolden/hexdocs-mcp/releases/tag/v0.1.1
[0.1.0]: https://github.com/bradleygolden/hexdocs-mcp/releases/tag/0.1.0