mcp-excel-to-markdown

inocentini/mcp-excel-to-markdown

3.2

If you are the rightful owner of mcp-excel-to-markdown and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP Excel to Markdown Server is a C# .NET 8.0 application designed to convert Excel files into Markdown format while preserving the tabular structure.

Tools

  1. convert_excel_to_markdown

    Converts Excel files to Markdown format using the MCP server.

MCP Excel to Markdown Server

Visão Geral

Este projeto implementa um MCP (Model Context Protocol) Server em C# .NET 8.0 que converte arquivos Excel (.xls/.xlsx) para formato Markdown (.md), mantendo a estrutura tabular e organizacional das planilhas.

Arquitetura

O projeto segue os princípios de Clean Architecture com separação clara de responsabilidades:

Estrutura de Pastas

comp-ExcelToMarkdownMCP/
├── MCP/                    # MCP Server Core (Camada de Interface)
│   ├── MCPServer.cs        # Classe principal do protocolo MCP
│   ├── ToolHandler.cs      # Gerenciador de ferramentas expostas
│   └── JsonRpcHandler.cs   # Handler para comunicação JSON-RPC
├── Excel/                  # Excel Processing Engine (Camada de Aplicação)
│   ├── IExcelProcessor.cs  # Interface para processamento de Excel
│   ├── ExcelReader.cs      # Classe para leitura de arquivos Excel
│   ├── WorksheetProcessor.cs # Processador individual de worksheets
│   └── DataExtractor.cs    # Extrator de dados tabulares
├── Markdown/               # Markdown Generation (Camada de Aplicação)
│   ├── IMarkdownGenerator.cs # Interface para geração de Markdown
│   ├── MarkdownBuilder.cs  # Construtor de documentos Markdown
│   ├── TableFormatter.cs   # Formatador de tabelas Markdown
│   └── FileWriter.cs       # Escritor de arquivos de saída
└── Models/                 # Models (Camada de Domínio)
    ├── WorksheetData.cs    # Entidade representando dados de uma worksheet
    ├── ConversionRequest.cs # Comando para solicitação de conversão
    └── ConversionResult.cs # Resultado da operação de conversão

Stack Tecnológico

  • .NET 8.0 - Framework principal
  • EPPlus ou ClosedXML - Processamento de arquivos Excel
  • System.Text.Json - Serialização JSON para protocolo MCP
  • Serilog - Logging estruturado
  • xUnit - Framework de testes

Funcionalidades

RF001 - Leitura de Arquivos Excel

  • Suporte para formatos .xls e .xlsx
  • Processamento de múltiplas worksheets
  • Preservação de estrutura tabular

RF002 - Conversão para Markdown

  • Geração de tabelas Markdown formatadas
  • Manutenção de hierarquia de worksheets
  • Preservação de dados numéricos e texto

RF003 - Interface MCP

  • Implementação completa do protocolo MCP
  • Ferramenta convert_excel_to_markdown exposta
  • Comunicação via JSON-RPC

Status do Projeto

✅ TASK-001 CONCLUÍDA: Setup da Estrutura do Projeto

  • ✅ Solution comp-ExcelToMarkdownMCP.sln criada
  • ✅ Projeto principal comp-ExcelToMarkdownMCP (.NET 8.0)
  • ✅ Projeto de testes comp-ExcelToMarkdownMCP.Tests
  • ✅ Estrutura de pastas: MCP/, Excel/, Markdown/, Models/
  • ✅ .gitignore atualizado para .NET

Próximos Passos

  1. TASK-002: Configurar dependências NuGet
  2. TASK-003: Implementar JsonRpcHandler
  3. TASK-004: Implementar MCP Server Core
  4. TASK-005: Implementar Excel Processing Engine
  5. TASK-006: Implementar Markdown Generation Engine
  6. TASK-007: Criar modelos de dados

Como Usar

# Restaurar dependências
dotnet restore

# Compilar projeto
dotnet build

# Executar testes
dotnet test

# Executar servidor MCP
dotnet run --project comp-ExcelToMarkdownMCP

Desenvolvimento

Este projeto segue as convenções de:

  • Clean Architecture
  • Padrão Repository
  • Dependency Injection
  • Test-Driven Development (TDD)

Contribuição

Para contribuir com o projeto, siga as diretrizes em PLANNING.md e mantenha a estrutura arquitetural definida.