MCP Server To Markdown

Converte vários formatos de arquivo para Markdown usando a Cloudflare AI.

Documentação

MCP Server To Markdown

Um poderoso servidor Model Context Protocol (MCP) que aproveita os serviços de IA da Cloudflare para converter vários formatos de arquivo em descrições em Markdown. Este servidor fornece uma interface padronizada para conversão e geração de descrições de arquivos sem interrupções.

Principais Recursos

Integração perfeita com os serviços de IA da Cloudflare
Geração eficiente de descrições em Markdown
Suporte abrangente a formatos de arquivo
Integração nativa com a API tomarkdown da Cloudflare
Interface MCP fácil de usar
Compatibilidade entre plataformas

Formatos de Arquivo Suportados

Categoria	Extensões de Arquivo
Documentos	.pdf
Imagens	.jpeg, .jpg, .png, .webp, .svg
Conteúdo Web	.html
Dados	.xml, .csv
Planilhas	.xlsx, .xlsm, .xlsb, .xls, .et, .ods, .numbers

Requisitos do Sistema

Node.js 18 ou posterior
Token de API Cloudflare válido
ID de conta Cloudflare ativo

Instalação

Instalando via Smithery

Para instalar o Markdown转换服务器 para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @FradSer/mcp-server-to-markdown --client claude

Instalação Manual

Instale globalmente usando npm:

npm install -g mcp-server-to-markdown

Configuração do Cliente MCP

Integração com Cursor

Navegue até as configurações do Cursor
Selecione "MCP" na barra lateral
Escolha "Adicionar novo servidor MCP global"

Aplique a seguinte configuração:

{
  "mcpServers": {
    "to-markdown": {
      "command": "mcp-server-to-markdown",
      "args": [
        "CLOUDFLARE_API_TOKEN": "your_api_token"
        "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
      ]
    }
  }
}

Configuração do Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "to-markdown": {
      "command": "mcp-server-to-markdown",
      "args": [
            "CLOUDFLARE_API_TOKEN": "your_api_token"
            "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
          ]
    }
  }
}

Configuração do ChatWise

Inicie o ChatWise
Acesse as Configurações
Selecione a seção Ferramentas
Clique em "+" para adicionar nova ferramenta
Configure com estes parâmetros:
- Tipo: stdio
- ID: to-markdown
- Comando: mcp-server-to-markdown
- Args:
```
CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id
```

Referência da API

Ferramenta to-markdown

Converte vários formatos de arquivo em descrições em Markdown.

Parâmetros de Entrada:

filePaths: Array (obrigatório) - Lista de caminhos de arquivos a processar

Estrutura da Resposta:

[
  {
    "filename": "example.pdf",
    "mimeType": "application/pdf",
    "description": "Generated Markdown description",
    "tokens": 123
  }
]

Guia de Desenvolvimento

Primeiros Passos

Clone e configure o ambiente:

git clone <repository-url>
cd mcp-server-to-markdown
cp .env.example .env

Configure as credenciais da Cloudflare:

CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

Instale as dependências e faça o build:

npm install
npm run build

Estrutura do Projeto

.
├── src/             # Source code
├── dist/            # Compiled output
├── types.ts         # Type definitions
└── .env             # Environment configuration

Scripts Disponíveis

npm run build - Compila o código TypeScript
npm run inspect - Executa com o inspetor MCP

Exemplo de Uso

const result = await toMarkdown({
  filePaths: [
    "/path/to/document.pdf",
    "/path/to/image.jpg"
  ]
});

Licença

Licença MIT

Este projeto é mantido por Frad LEE