Teleport Documentation

teleport-docs-mcp

Construa um servidor MCP para Teleport Documentation

Como funciona

Embeddings gerados a partir de teleport docs são salvos em um banco de dados Chroma. Uma ferramenta MCP é fornecida para fazer a busca vetorial e retornar o resultado do banco de dados. Observe que nenhum modelo LLM é usado para interpretar o resultado dentro da ferramenta MCP. Cabe à ferramenta de IA que chama a ferramenta MCP interpretar o resultado.

Uso a partir do Dockerhub

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

stdio

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

ou no formato de config json:

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

note que leva alguns segundos para iniciar.

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

Desenvolvimento Local

uv

Instale uv:

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

E instale os pacotes:

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

Configuração MCP (stdio)

Substitua pelo caminho do seu diretório!

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

Recriar banco de dados

O banco de dados vetorial é pré-populado e fornecido com este repositório. Você pode atualizar os dados removendo os índices existentes e copiar as páginas mais recentes do repositório OSS GitHub do teleport.

Para preparar os arquivos:

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 gerar um novo banco de dados:

rm -rf chroma_index/
python3 embed.py

Porém, leva um tempo para gerar.