mcpField
H
HexDocs MCP Server

HexDocs MCP Server

Local
github.com/bradleygoldenDeveloper Tools0Updated 82w ago
Repository

About HexDocs MCP Server

HexDocs MCP Server provides semantic search over Hex package documentation using embeddings and a SQLite database generated by hexdocs_mcp. It is intended for AI applications and tools that need searchable Hex documentation.

Key features

  1. 01Semantic search across Hex documentation
  2. 02Use hexdocs_mcp-generated embeddings
  3. 03Read documentation from SQLite
  4. 04Install with npx
  5. 05Configure a custom database path

Use cases

  1. 01Search Hex package documentation from an AI tool
  2. 02Find documentation relevant to a coding task
  3. 03Choose a custom SQLite database location

MCP support

The server exposes semantic search for Hex package documentation to MCP-compatible AI tools. It uses a SQLite database prepared by the hexdocs_mcp Elixir package.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hexdocs": {
      "command": "npx",
      "args": [
        "-y",
        "hexdocs-mcp-server"
      ]
    }
  }
}
Run commandnpx -y hexdocs-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmhexdocs-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

HexDocs MCP Server

A TypeScript server implementing the Model Context Protocol (MCP) that provides semantic search capabilities for Hex package documentation. It's designed to work seamlessly with embeddings generated by the hexdocs_mcp Elixir package, making Hex documentation easily searchable in AI applications.

Features

  • MCP-compatible server for searching Hex package documentation
  • Integrates with embeddings generated by the hexdocs_mcp Elixir package
  • Built on the Model Context Protocol standard for compatibility with AI tools
  • Easy installation via npx for quick setup
  • Simple configuration with customizable database paths

Requirements

  • Node.js 18 or later
  • Access to a hexdocs_mcp generated SQLite database (requires running mix hex.docs.mcp fetch PACKAGE on the desired packages first)

Configuration

The server looks for the SQLite database created by the hexdocs_mcp package. By default, it uses ~/.hexdocs_mcp/hexdocs_mcp.db, but you can specify a custom path:

# Example: Set custom database path
export HEXDOCS_MCP_PATH=/path/to/custom/directory

Integration

The server can be integrated with various AI tools that support the Model Context Protocol. Here's an example for Cursor:

Add this to your mcp.json:

{
  "mcpServers": {
    "hexdocs-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hexdocs-mcp-server"
      ]
    }
  }
}

Pro Tip

When you're vibing with an agent and you find that you don't have the given documentation for a specific tool, you can have the AI run the mix hex.docs.mcp fetch ... command for you so you don't have to.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

This project is licensed under MIT - see the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.