{"id":24161552,"url":"https://github.com/zcaceres/markdownify-mcp","last_synced_at":"2025-05-14T20:06:59.321Z","repository":{"id":268781463,"uuid":"905450127","full_name":"zcaceres/markdownify-mcp","owner":"zcaceres","description":"A Model Context Protocol server for converting almost anything to Markdown","archived":false,"fork":false,"pushed_at":"2025-01-24T14:22:44.000Z","size":133,"stargazers_count":1175,"open_issues_count":7,"forks_count":93,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-03T03:54:36.174Z","etag":null,"topics":["ai","anthropic","anthropic-ai","anthropic-claude","markdown","mcp","model-context-protocol","ocr","tools"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zcaceres.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-18T21:14:52.000Z","updated_at":"2025-04-03T03:52:56.000Z","dependencies_parsed_at":"2024-12-18T22:30:18.795Z","dependency_job_id":"572fe15b-6b70-448b-901d-96f65f70f978","html_url":"https://github.com/zcaceres/markdownify-mcp","commit_stats":null,"previous_names":["zcaceres/mcp-ocr","zcaceres/mcp-markdownify-server","zcaceres/markdownify-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fmarkdownify-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fmarkdownify-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fmarkdownify-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fmarkdownify-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zcaceres","download_url":"https://codeload.github.com/zcaceres/markdownify-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247941692,"owners_count":21022038,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","anthropic","anthropic-ai","anthropic-claude","markdown","mcp","model-context-protocol","ocr","tools"],"created_at":"2025-01-12T17:17:19.129Z","updated_at":"2025-05-14T20:06:59.312Z","avatar_url":"https://github.com/zcaceres.png","language":"TypeScript","funding_links":[],"categories":["Productivity","File Management MCP Servers","TypeScript","A01_文本生成_文本对话","📚 Projects (1974 total)","MCP 服务器精选列表","Content Creation","HarmonyOS","サーバー実装","Table of Contents","Legend","Search \u0026 Data Extraction","Uncategorized","カテゴリ","Containerised MCP Servers","📦 Other","MCP Ecosystem","MCP Servers","Other (4)","Data Science Tools","MCP Servers \u0026 Protocol","服务器实现"],"sub_categories":["Documents","大语言对话模型及数据","MCP Servers","📊 数据分析、处理与可视化","Windows Manager","🛠️ \u003ca name=\"other-tools-and-integrations\"\u003e\u003c/a\u003eその他のツールと統合","Other Tools and Integrations","🧮 Data Science Tools","How to Submit","Uncategorized","📝 \u003ca name=\"content--media\"\u003e\u003c/a\u003eコンテンツ・メディア","AI \u0026 Machine Learning","Servers","Media \u0026 Creativity","Specification-Driven Agent Development","媒体与娱乐"],"readme":"# Markdownify MCP Server\n\n\u003e Help! I need someone with a Windows computer to help me add support for Markdownify-MCP on Windows. PRs exist but I cannot test them. Post [here](https://github.com/zcaceres/markdownify-mcp/issues/18) if interested.\n\n![markdownify mcp logo](logo.jpg)\n\nMarkdownify 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.\n\n\u003ca href=\"https://glama.ai/mcp/servers/bn5q4b0ett\"\u003e\u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/bn5q4b0ett/badge\" alt=\"Markdownify Server MCP server\" /\u003e\u003c/a\u003e\n\n## Features\n\n- Convert multiple file types to Markdown:\n  - PDF\n  - Images\n  - Audio (with transcription)\n  - DOCX\n  - XLSX\n  - PPTX\n- Convert web content to Markdown:\n  - YouTube video transcripts\n  - Bing search results\n  - General web pages\n- Retrieve existing Markdown files\n\n## Getting Started\n\n1. Clone this repository\n2. Install dependencies:\n   ```\n   pnpm install\n   ```\n\nNote: this will also install `uv` and related Python depdencies.\n\n3. Build the project:\n   ```\n   pnpm run build\n   ```\n4. Start the server:\n   ```\n   pnpm start\n   ```\n\n## Development\n\n- Use `pnpm run dev` to start the TypeScript compiler in watch mode\n- Modify `src/server.ts` to customize server behavior\n- Add or modify tools in `src/tools.ts`\n\n## Usage with Desktop App\n\nTo integrate this server with a desktop app, add the following to your app's server configuration:\n\n```js\n{\n  \"mcpServers\": {\n    \"markdownify\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"{ABSOLUTE PATH TO FILE HERE}/dist/index.js\"\n      ],\n      \"env\": {\n        // By default, the server will use the default install location of `uv`\n        \"UV_PATH\": \"/path/to/uv\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n- `youtube-to-markdown`: Convert YouTube videos to Markdown\n- `pdf-to-markdown`: Convert PDF files to Markdown\n- `bing-search-to-markdown`: Convert Bing search results to Markdown\n- `webpage-to-markdown`: Convert web pages to Markdown\n- `image-to-markdown`: Convert images to Markdown with metadata\n- `audio-to-markdown`: Convert audio files to Markdown with transcription\n- `docx-to-markdown`: Convert DOCX files to Markdown\n- `xlsx-to-markdown`: Convert XLSX files to Markdown\n- `pptx-to-markdown`: Convert PPTX files to Markdown\n- `get-markdown-file`: Retrieve an existing Markdown file. File extension must end with: *.md, *.markdown.\n  \n  OPTIONAL: set `MD_SHARE_DIR` env var to restrict the directory from which files can be retrieved, e.g. `MD_SHARE_DIR=[SOME_PATH] pnpm run start` \n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcaceres%2Fmarkdownify-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzcaceres%2Fmarkdownify-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcaceres%2Fmarkdownify-mcp/lists"}