Skip to main content

Model Context Protocol (MCP) server for GenLayer documentation

Project description

GenLayer Documentation MCP Server

A standardized, shareable Model Context Protocol (MCP) server that packages and exposes the GenLayer documentation (genlayer-docs.txt) to any AI assistant (including Claude Desktop, Cursor, Windsurf, Gemini, and others).

By packaging this as a Python project with a pyproject.toml and utilizing the official mcp SDK, anyone can run it with a standard Python install — no manual file paths or dependency wrangling.

Available Tools

Once registered, the server exposes the following tools:

  1. search_docs(query: string, top_k: int = 5): Search the GenLayer documentation for relevant sections matching a query. Returns top matching sections along with their hierarchical title breadcrumbs (e.g., What is GenLayer > Core Technology > On-Chain AI Processing) and starting line numbers.

  2. get_section(title: string): Retrieve the full content of a specific documentation section matching the specified heading title.

  3. list_sections(): List all headings and subheadings present in the GenLayer documentation along with their starting line numbers.


Quick Start (Recommended)

This is the setup verified to work with a standard Python installation on Windows, macOS, and Linux.

1. Install the package

From PyPI:

pip install genlayer-docs-mcp

Or from source (after cloning this repo):

pip install .

2. Register it with your AI client

Add the server inside the mcpServers block of your client's MCP config (Claude Desktop on Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "genlayer-docs": {
      "command": "python",
      "args": [
        "-m",
        "genlayer_docs_mcp"
      ]
    }
  }
}

Why python -m? It uses the Python interpreter already on your PATH, so there is nothing extra to install (unlike uvx, which requires uv to be installed first). Restart your client after saving, and the three tools above will appear.

For Cursor / Windsurf, use the same values in the editor's MCP settings:

  • Type: command
  • Command: python
  • Args: -m genlayer_docs_mcp

Alternative: Zero-install with uvx

If you have uv installed, you can run the server without installing it first. Anyone in the world can use this on any AI client with zero local files:

{
  "mcpServers": {
    "genlayer-docs": {
      "command": "uvx",
      "args": ["genlayer-docs-mcp"]
    }
  }
}

Cursor / Windsurf command: uvx genlayer-docs-mcp

Requires uv/uvx on your PATH. Install it with winget install astral-sh.uv (Windows) or see the uv install guide.


Alternative: Install directly from GitHub (no PyPI needed)

To track the latest source, install straight from the public repository:

  • Using pip:

    pip install "git+https://github.com/Laegend14/Genlayer-mcp"
    
  • Using uvx (zero-install):

    {
      "mcpServers": {
        "genlayer-docs": {
          "command": "uvx",
          "args": [
            "--from",
            "git+https://github.com/Laegend14/Genlayer-mcp",
            "genlayer-docs-mcp"
          ]
        }
      }
    }
    

Alternative: Global install via pipx

Users who prefer an isolated global install can use pipx:

# From PyPI
pipx install genlayer-docs-mcp

# Or from GitHub
pipx install "git+https://github.com/Laegend14/Genlayer-mcp"

Then configure the command in any AI client as:

  • Command: genlayer-docs-mcp (no arguments required)

Note: this requires the pipx scripts directory to be on your PATH (pipx ensurepath). If your client can't find the genlayer-docs-mcp executable, use the Quick Start python -m method instead.


Development

Clone the repo and install in editable mode:

git clone https://github.com/Laegend14/Genlayer-mcp
cd Genlayer-mcp
pip install -e .

Run the server directly to confirm it loads the documentation:

python -m genlayer_docs_mcp

You should see a log line reporting the number of parsed documentation sections.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

genlayer_docs_mcp-0.1.1.tar.gz (212.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

genlayer_docs_mcp-0.1.1-py3-none-any.whl (215.8 kB view details)

Uploaded Python 3

File details

Details for the file genlayer_docs_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: genlayer_docs_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 212.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for genlayer_docs_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 a951c4b49b752a38ed3391ca3b3d259340a779bc6114ae364117821046d96061
MD5 cb06d4b48f0e9efccb584f812afa717e
BLAKE2b-256 4c288f5a67018d87c576eb01a457c3ddcd1390d37bef247b310e8073af5df058

See more details on using hashes here.

File details

Details for the file genlayer_docs_mcp-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for genlayer_docs_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 acdd90e2a52459258df3363e721b791f1026345e4618d16767b55bc3313bdbe7
MD5 0ed0ebf1f52ce383f51c976a92066e15
BLAKE2b-256 a8de76675c356b29eeb758a673d4873f4be0988407673a8f1ab83e8a12379bc0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page