Teleport Documentation

teleport-docs-mcp

Construye un servidor MCP para la Documentación de Teleport

Cómo funciona

Los embeddings generados a partir de la documentación de teleport se guardan en una base de datos Chroma. Se proporciona una herramienta MCP para realizar la búsqueda vectorial y devolver el resultado de la base de datos. Ten en cuenta que no se utiliza ningún modelo LLM para interpretar el resultado dentro de la herramienta MCP. Depende de la herramienta de IA que llame a la herramienta MCP interpretar el resultado.

Uso desde Dockerhub

https://hub.docker.com/r/stevetelelport/teleport-docs-mcp

stdio

docker run --rm -i stevetelelport/teleport-docs-mcp:v0.1.0

o en formato de configuración json:

{
  "mcpServers": {
    "teleport-docs": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "stevetelelport/teleport-docs-mcp:v0.1.0"
      ]
    }
  }
}

ten en cuenta que tarda unos segundos en iniciarse.

sse

docker run -d --name teleport-docs-mcp-sse -p 8282:8000 stevetelelport/teleport-docs-mcp:v0.1.0 uv run main.py --sse --host 0.0.0.0

Desarrollo local

uv

Instala uv:

curl -Ls https://astral.sh/uv/install.sh | sh

E instala los paquetes:

uv pip install -r requirement.txt

Construir docker local

Construir

$ docker build -t teleport-docs-mcp .

Stdio

$ docker run --rm -i teleport-docs-mcp

SSE

$ docker run --name teleport-docs-mcp-sse -d -p 8282:8000 teleport-docs uv main.py --sse --host 0.0.0.0

Configuración de MCP (stdio)

¡Reemplaza con la ruta de tu directorio!

{
  "mcpServers": {
    "teleport-docs": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/teleport-docs-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Reconstruir la base de datos

La base de datos vectorial está precargada y se proporciona con este repositorio. Puedes actualizar los datos eliminando los índices existentes y copiando las páginas más recientes del repositorio de GitHub de teleport OSS.

Para preparar los archivos:

rm -rf docs/pages
rm -rf docs/pages_fixed
cp /path/to/teleport/docs/pages docs/pages`
cp /path/to/teleport/examples docs/examples`
python3 fix_include.py

Para generar una nueva base de datos:

rm -rf chroma_index/
python3 embed.py

Sin embargo, la generación tarda un tiempo.