Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zcaceres/markdownify-mcp
A Model Context Protocol server for converting almost anything to Markdown
https://github.com/zcaceres/markdownify-mcp
ai anthropic anthropic-ai anthropic-claude markdown mcp model-context-protocol ocr tools
Last synced: 20 days ago
JSON representation
A Model Context Protocol server for converting almost anything to Markdown
- Host: GitHub
- URL: https://github.com/zcaceres/markdownify-mcp
- Owner: zcaceres
- License: mit
- Created: 2024-12-18T21:14:52.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-12-29T16:46:58.000Z (about 1 month ago)
- Last Synced: 2024-12-29T17:30:42.390Z (about 1 month ago)
- Topics: ai, anthropic, anthropic-ai, anthropic-claude, markdown, mcp, model-context-protocol, ocr, tools
- Language: TypeScript
- Homepage:
- Size: 85 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - zcaceres/markdownify-mcp - ほぼすべてのファイルやウェブコンテンツをMarkdownに変換するMCPサーバー (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
README
# 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.
## 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.
3. Build the project:
```
pnpm run build
```
4. 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](LICENSE) file for details.