Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/blajanclaudiu/cotton

https://github.com/blajanclaudiu/cotton

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.5%) to scientific vocabulary
Last synced: 9 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: blajanclaudiu
  • License: mit
  • Language: TypeScript
  • Default Branch: main
  • Size: 79.1 KB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 2
  • Releases: 0
Created about 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme License

README.md

Markdownify MCP Server

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.

Markdownify Server MCP server

Features

  • Convert multiple file types to Markdown:
    • PDF
    • Images
    • Audio (with transcription)
    • DOCX
    • XLSX
    • PPTX
  • Convert web content to Markdown:
    • YouTube video transcripts
    • Bing search results
    • General web pages
  • Retrieve existing Markdown files

Getting Started

  1. Clone this repository
  2. Install dependencies: pnpm install

Note: this will also install uv and related Python depdencies.

  1. Build the project: pnpm run build
  2. Start the server: pnpm start

Development

  • Use pnpm run dev to start the TypeScript compiler in watch mode
  • Modify src/server.ts to customize server behavior
  • Add or modify tools in src/tools.ts

Usage with Desktop App

To integrate this server with a desktop app, add the following to your app's server configuration:

js { "mcpServers": { "markdownify": { "command": "node", "args": [ "{ABSOLUTE PATH TO FILE HERE}/dist/index.js" ], "env": { // By default, the server will use the default install location of `uv` "UV_PATH": "/path/to/uv" } } } }

Available Tools

  • youtube-to-markdown: Convert YouTube videos to Markdown
  • pdf-to-markdown: Convert PDF files to Markdown
  • bing-search-to-markdown: Convert Bing search results to Markdown
  • webpage-to-markdown: Convert web pages to Markdown
  • image-to-markdown: Convert images to Markdown with metadata
  • audio-to-markdown: Convert audio files to Markdown with transcription
  • docx-to-markdown: Convert DOCX files to Markdown
  • xlsx-to-markdown: Convert XLSX files to Markdown
  • pptx-to-markdown: Convert PPTX files to Markdown
  • get-markdown-file: Retrieve an existing Markdown file

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Owner

  • Login: blajanclaudiu
  • Kind: user

GitHub Events

Total
  • Issues event: 1
  • Watch event: 1
  • Create event: 1
Last Year
  • Issues event: 1
  • Watch event: 1
  • Create event: 1

Dependencies

package.json npm
  • @types/node ^22.9.3 development
  • bun ^1.1.41 development
  • sdk link:@types/modelcontextprotocol/sdk development
  • shx ^0.3.4 development
  • ts-jest ^29.2.5 development
  • typescript ^5.6.2 development
  • @modelcontextprotocol/sdk 1.0.1
  • zod ^3.24.1
pnpm-lock.yaml npm
  • babel__core@7.20.5
  • babel__generator@7.6.8
  • babel__template@7.4.4
  • babel__traverse@7.20.6
  • bun-darwin-aarch64@1.1.42
  • bun-darwin-x64-baseline@1.1.42
  • bun-darwin-x64@1.1.42
  • bun-linux-aarch64-musl@1.1.42
  • bun-linux-aarch64@1.1.42
  • bun-linux-x64-baseline@1.1.42
  • bun-linux-x64-musl-baseline@1.1.42
  • bun-linux-x64-musl@1.1.42
  • bun-linux-x64@1.1.42
  • bun-windows-x64-baseline@1.1.42
  • bun-windows-x64@1.1.42
  • code-frame@7.26.2
  • commons@3.0.1
  • compat-data@7.26.3
  • console@29.7.0
  • core@29.7.0
  • core@7.26.0
  • environment@29.7.0
  • expect-utils@29.7.0
  • expect@29.7.0
  • fake-timers@10.3.0
  • fake-timers@29.7.0
  • gen-mapping@0.3.8
  • generator@7.26.3
  • globals@29.7.0
  • graceful-fs@4.1.9
  • helper-compilation-targets@7.25.9
  • helper-module-imports@7.25.9
  • helper-module-transforms@7.26.0
  • helper-plugin-utils@7.25.9
  • helper-string-parser@7.25.9
  • helper-validator-identifier@7.25.9
  • helper-validator-option@7.25.9
  • helpers@7.26.0
  • istanbul-lib-coverage@2.0.6
  • istanbul-lib-report@3.0.3
  • istanbul-reports@3.0.4
  • load-nyc-config@1.1.0
  • node@22.10.2
  • parser@7.26.3
  • plugin-syntax-async-generators@7.8.4
  • plugin-syntax-bigint@7.8.3
  • plugin-syntax-class-properties@7.12.13
  • plugin-syntax-class-static-block@7.14.5
  • plugin-syntax-import-attributes@7.26.0
  • plugin-syntax-import-meta@7.10.4
  • plugin-syntax-json-strings@7.8.3
  • plugin-syntax-jsx@7.25.9
  • plugin-syntax-logical-assignment-operators@7.10.4
  • plugin-syntax-nullish-coalescing-operator@7.8.3
  • plugin-syntax-numeric-separator@7.10.4
  • plugin-syntax-object-rest-spread@7.8.3
  • plugin-syntax-optional-catch-binding@7.8.3
  • plugin-syntax-optional-chaining@7.8.3
  • plugin-syntax-private-property-in-object@7.14.5
  • plugin-syntax-top-level-await@7.14.5
  • plugin-syntax-typescript@7.25.9
  • remapping@2.3.0
  • reporters@29.7.0
  • resolve-uri@3.1.2
  • schema@0.1.3
  • schemas@29.6.3
  • sdk@1.0.1
  • set-array@1.2.1
  • source-map@29.6.3
  • sourcemap-codec@1.5.0
  • stack-utils@2.0.3
  • template@7.25.9
  • test-result@29.7.0
  • test-sequencer@29.7.0
  • trace-mapping@0.3.25
  • transform@29.7.0
  • traverse@7.26.4
  • typebox@0.27.8
  • types@29.6.3
  • types@7.26.3
  • v8-coverage@0.2.3
  • yargs-parser@21.0.3
  • yargs@17.0.33
pyproject.toml pypi
  • markitdown >=0.0.1a3
uv.lock pypi
  • annotated-types 0.7.0
  • anyio 4.7.0
  • audioop-lts 0.2.1
  • beautifulsoup4 4.12.3
  • certifi 2024.12.14
  • cffi 1.17.1
  • charset-normalizer 3.4.0
  • cobble 0.1.4
  • colorama 0.4.6
  • cryptography 44.0.0
  • defusedxml 0.7.1
  • distro 1.9.0
  • et-xmlfile 2.0.0
  • h11 0.14.0
  • httpcore 1.0.7
  • httpx 0.28.1
  • idna 3.10
  • jiter 0.8.2
  • lxml 5.3.0
  • mammoth 1.8.0
  • markdownify 0.14.1
  • markitdown 0.0.1a3
  • numpy 2.2.0
  • ocr 0.1.0
  • openai 1.58.1
  • openpyxl 3.1.5
  • pandas 2.2.3
  • pathvalidate 3.2.1
  • pdfminer-six 20240706
  • pillow 11.0.0
  • puremagic 1.28
  • pycparser 2.22
  • pydantic 2.10.4
  • pydantic-core 2.27.2
  • pydub 0.25.1
  • python-dateutil 2.9.0.post0
  • python-pptx 1.0.2
  • pytz 2024.2
  • requests 2.32.3
  • six 1.17.0
  • sniffio 1.3.1
  • soupsieve 2.6
  • speechrecognition 3.12.0
  • standard-aifc 3.13.0
  • standard-chunk 3.13.0
  • tqdm 4.67.1
  • typing-extensions 4.12.2
  • tzdata 2024.2
  • urllib3 2.2.3
  • xlsxwriter 3.2.0
  • youtube-transcript-api 0.6.3