convez.ai
MCP ServerIntegração & APIsIntermediário
RileyG00

McpGleam

RileyG00/McpGleam

Documentação do Gleam sob demanda via MCP para Claude e clientes compatíveis

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em C# que fornece acesso à documentação atualizada da linguagem de programação Gleam através do Gleam Tour. Permite que LLMs consultem categorias de documentação e recuperem conteúdo técnico estruturado sobre sintaxe, conceitos e bibliotecas.

Instalação

$npx convez-ai RileyG00/McpGleam

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
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
v1.2.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Assistentes de IA aprendendo ou ensinando Gleam
  • Consulta rápida de sintaxe e bibliotecas Gleam durante desenvolvimento
  • Integração de docs oficiais em fluxos de coding automático

Veredito

Ferramenta bem-construída em .NET para expor docs do Gleam via MCP com parsing confiável. Útil especificamente para quem trabalha com Gleam e quer contexto vivo na IDE, mas nicho limitado ao ecossistema dessa linguagem.

README

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

McpGleam: Gleam Programming Language Documentation MCP Server

McpGleam is a Model Context Protocol (MCP) server written in C# (.NET 10.0) that fetches and parses documentation for the Gleam programming language from The Gleam Tour. It allows LLMs and MCP clients to query available documentation categories and retrieve up-to-date documentation content.


Features

The server exposes the following MCP tools:

  1. list_available_docs

    • Description: Returns a JSON array containing all available documentation items, their category, and the path/URL to fetch additional information.
    • Usage: Use this to discover what Gleam concepts, syntax, and libraries are documented in the tour.
  2. get_item_documentation

    • Description: Fetches the up-to-date documentation details for a single item by its URL/path fragment (e.g. basics/hello-world).
    • Parameters:
      • documentationUrl (string): The URL path fragment at which the documentation can be retrieved.
  3. get_multiple_item_documentation

    • Description: Fetches up-to-date documentation details for one or more URLs. Useful for batch requests.
    • Parameters:
      • documentationUrl (string[]): Array of URL path fragments.

Project Structure

  • Program.cs: Main entry point that sets up the dependency injection, HTTP clients, registers MCP tools, and starts the Stdio server transport.
  • Tools/Documentation.cs: Contains the MCP tool implementations and descriptions.
  • Utils/ParserUtil.cs: Helper class using regular expressions to parse the Table of Contents and clean up html fragments into raw text documentation content.
  • Models/DocumentationItem.cs: Holds structured data for parsed items (Category, Name, Path).
  • McpGleam.Tests/: Unit tests verifying parser behaviors.

Prerequisites


Building and Running

Build the Project

To compile the project, run:

dotnet build

Run Tests

To run unit tests:

dotnet test

Run the Server

The server runs over Standard Input/Output (Stdio) transport:

dotnet run --project McpGleam/McpGleam.csproj

Configuration for MCP Clients

To integrate McpGleam with MCP clients (such as Claude Desktop or Cursor), add the following server configuration to your claude_desktop_config.json or equivalent client configuration file:

Option 1: Running via dotnet run (Development)

{
  "mcpServers": {
    "gleam-docs": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "c:/Users/rg102529/source/repos/McpGleam/McpGleam/McpGleam.csproj"
      ]
    }
  }
}

Option 2: Running the Published Executable (Production)

First, publish the application:

dotnet publish McpGleam/McpGleam.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true

Then configure the client to run the executable:

{
  "mcpServers": {
    "gleam-docs": {
      "command": "c:/Users/rg102529/source/repos/McpGleam/McpGleam/bin/Release/net10.0/win-x64/publish/McpGleam.exe"
    }
  }
}

License

This project is licensed under the terms of the license file included in the root directory.

Ver o original no GitHub

Bom para

Relacionados