内容
<p align="center">
<img src="logo.png" alt="inktomd" width="120" />
</p>
# inktomd MCP 服务器
将任何文件或网址直接从 Claude、Claude Code、Cursor 或任何与 MCP 兼容的 AI 代理转换为干净的、适合 AI 的 Markdown。
inktomd 通过将原始文档转换为干净的 Markdown（AI 模型训练的格式），减少高达 63% 的 token 使用量。
## 工具
| 工具 | 描述 |
|------|-------------|
| `convert_url` | 将任何网页、文章或网络文档转换为 Markdown |
| `convert_file` | 将本地文件（PDF、Word、Excel 等）转换为 Markdown |
| `convert_youtube` | 提取 YouTube 视频转录为 Markdown |
| `convert_arxiv` | 将 ArXiv 研究论文转换为 Markdown |
| `list_supported_formats` | 列出所有支持的文件格式和网址类型 |
## 支持的格式
**文件：** PDF、Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx)、EPUB、HTML、CSV、JSON、XML、Jupyter (.ipynb)、电子邮件 (.eml/.msg)、ZIP、7-Zip (.7z)
**网址：** 任意网页、YouTube、ArXiv、维基百科、Substack、RSS 源、Google Docs、GitHub
## 安装与配置
**注意：** PyPI 软件包即将推出 — 请点亮仓库以接收通知。
### 从源代码运行
```bash
git clone https://github.com/hadirizvi093/inktomd
cd inktomd/mcp
pip install -r requirements.txt
python server.py
```
### Claude 桌面版
添加到您的 Claude 桌面版配置文件中：
**macOS：** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows：** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"inktomd": {
"command": "python",
"args": ["C:/path/to/inktomd-mcp/server.py"]
}
}
}
```
### Claude 代码
```bash
claude mcp add inktomd python C:/path/to/inktomd-mcp/server.py
```
或添加到项目中的 `.claude/settings.json` 中：
```json
{
"mcpServers": {
"inktomd": {
"command": "python",
"args": ["C:/path/to/inktomd-mcp/server.py"]
}
}
}
```
### Cursor
前往 Cursor 设置 → 功能 → MCP → 添加新的 MCP 服务器：
```json
{
"inktomd": {
"command": "python",
"args": ["C:/path/to/inktomd-mcp/server.py"]
}
}
```
## 使用示例
**转换研究论文：**
> 将此 ArXiv 论文转换为 Markdown：https://arxiv.org/abs/2301.07041
**转换本地 PDF：**
> 将 /Users/me/documents/report.pdf 转换为 Markdown
**提取 YouTube 转录：**
> 获取 https://youtube.com/watch?v=dQw4w9WgXcQ 的转录
**转换网页：**
> 将 https://example.com/article 转换为 Markdown
**检查支持的格式：**
> inktomd 支持哪些文件格式？
## 隐私
文件在 inktomd 的后端（Google Cloud Run）上进行内存处理，并在转换后立即删除。不会存储任何内容。不需要身份验证。
## 限制
- 免费层：每天 10 次转换
- 最大文件大小：20MB
- 专业计划：无限转换 — inktomd.com/pricing
## 链接
- 网站：https://www.inktomd.com
- 定价：https://www.inktomd.com/pricing
- 联系方式：hadi@inktomd.com
