convez.ai
MCP Server
GoLinks

golinks-mcp

GoLinks/golinks-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

Repo for the GoLinks MCP server

Instalação

$npx convez-ai GoLinks/golinks-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 mês
Versão
—
Issues abertas
4
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

GoLinks MCP Server

An MCP server that exposes GoLinks as tools for AI assistants. Built with FastMCP.

Hosted HTTP Mode

This server is intended to run as a hosted remote MCP server over Streamable HTTP.

Public endpoint shape:

https://mcp.golinks.io/mcp

Local development endpoint shape:

http://localhost:8000/mcp

Authentication

The hosted server does not use a shared GOLINKS_API_TOKEN.

MCP clients should send a per-user GoLinks OAuth/API bearer token with each request:

Authorization: Bearer YOUR_TOKEN

The MCP server forwards that header to api.golinks.io. GoLinks remains responsible for token validation, scope enforcement, refresh, storage, and revocation.

An OAuth client must be pre-registered in your GoLinks workspace with:

  • Allowed scopes: golinks:read, golinks:write, search:read
  • Redirect URIs: the exact callback URL(s) your MCP client uses

To do so, visit the OAuth Apps page under Developer Tools, on the GoLinks dashboard

Local Development

This project uses Python 3.12 and uv.

  1. Install Python 3.12.
  2. Install uv.
  3. Create the local environment and install dependencies:
uv sync
  1. Run the MCP server locally:
uv run python -m golinks_mcp

The server binds to 0.0.0.0:8000 by default. Override with MCP_HOST and MCP_PORT if you need a different host or port:

MCP_HOST=127.0.0.1 MCP_PORT=9000 uv run python -m golinks_mcp
  1. Verify health and OAuth discovery:
curl http://localhost:8000/health
curl http://localhost:8000/.well-known/oauth-authorization-server

Docker

Build and run locally:

docker build -t golinks-mcp .
docker run --rm -p 8000:8000 golinks-mcp

Tools

ToolDescriptionScope
list_golinksList all company go links (paginated)golinks:read
get_golinkGet a single go link by name or numeric IDgolinks:read
search_golinksFuzzy keyword search across go linkssearch:read
create_golinkCreate a new go link (standard only)golinks:write
Ver o original no GitHub

Relacionados