MarkItDown MCP
这 markitdown-mcp 该包提供了一个轻量级的STDIO、流式HTTP和SSE MCP服务器，用于调用MarkItDown。
它公开了一个工具： convert_to_markdown(uri)，其中uri可以是任何 http:, https:, file:，或 data: URI。
安装
要安装该软件包，请使用pip：
pip install markitdown-mcp用法
要运行MCP服务器，请使用STDIO（默认）使用以下命令：
markitdown-mcp要运行MCP服务器，请使用Streamable HTTP和SSE使用以下命令：
markitdown-mcp --http --host 127.0.0.1 --port 3001在Docker中运行
跑 markitdown-mcp 在Docker中，使用提供的Dockerfile构建Docker镜像：
docker build -t markitdown-mcp:latest .并使用以下命令运行它：
docker run -it --rm markitdown-mcp:latest这对于远程URI就足够了。要访问本地文件，您需要将本地目录挂载到容器中。例如，如果您想访问中的文件 /home/user/data，您可以运行：
docker run -it --rm -v /home/user/data:/workdir markitdown-mcp:latest装载后，数据下的所有文件都可以在以下位置访问 /workdir 在容器中。例如，如果您有一个文件 example.txt 在 /home/user/data，它将在集装箱内 /workdir/example.txt.
从克劳德桌面访问
建议在运行Claude Desktop的MCP服务器时使用Docker镜像。
跟随 这些指示 访问克劳德的 claude_desktop_config.json 文件。
编辑它以包含以下JSON条目：
{
"mcpServers": {
"markitdown": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"markitdown-mcp:latest"
]
}
}
}如果你想挂载一个目录，请相应地调整它：
{
"mcpServers": {
"markitdown": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-v",
"/home/user/data:/workdir",
"markitdown-mcp:latest"
]
}
}
}调试
要调试MCP服务器，您可以使用 mcpinspector 工具。
npx @modelcontextprotocol/inspector然后，您可以通过指定的主机和端口（例如。， http://localhost:5173/).
如果使用STDIO：
- 选择
STDIO作为运输类型， - 输入
markitdown-mcp作为命令，以及 - 点击
Connect
如果使用流式HTTP：
- 选择
Streamable HTTP作为运输类型， - 输入
http://127.0.0.1:3001/mcp作为URL，以及 - 点击
Connect
如果使用SSE：
- 选择
SSE作为运输类型， - 输入
http://127.0.0.1:3001/sse作为URL，以及 - 点击
Connect
最后：
- 点击
Tools选项卡， - 点击
List Tools, - 点击
convert_to_markdown，以及 - 在任何有效的URI上运行该工具。
安全考虑
服务器不支持身份验证，如果运行它的用户有权限，则以该权限运行。因此，在SSE或Streamable HTTP模式下运行时，建议运行绑定到的服务器 localhost （默认）。
商标
此项目可能包含项目、产品或服务的商标或徽标。授权使用Microsoft 商标或徽标必须遵守 微软商标和品牌指南. 在本项目的修改版本中使用Microsoft商标或徽标不得造成混淆或暗示Microsoft赞助。 任何使用第三方商标或徽标的行为均受这些第三方政策的约束。