DocumentBrain
特性
工具
| 工具 | 说明 |
|---|---|
| 阅读任何文档 | 读取任何支持的文档并返回其文本内容，包括图像的OCR。 |
| 将文件保存到PC | 将内容保存到计算机上指定路径的文件中。 |
资源
| 资源 | URI | 描述 |
|---|---|---|
| 本地文档目录 | docs://files | 列出当前工作目录中的所有文件。 |
| 文件内容 | docs://file/{filename} | 检索特定文件的转换文本内容。 |
提示
| 提示 | 描述 |
|---|---|
analyze_data | 根据用户提供的文本生成一首有创意的四行歌曲。 |
安装
先决条件
- Python>=3.12
从源代码安装
pip install -e .从PyPI安装
pip install vvin-document-brain用法
运行MCP服务器
mcp-document-brain在游标中配置
将以下内容添加到Cursor MCP配置文件中 ~/.cursor/mcp.json:
使用 uvx （推荐--无需安装）：
{
"mcpServers": {
"DocumentBrain": {
"command": "uvx",
"args": ["vvin-document-brain"]
}
}
}缓存路径问题？ 如果uvx失败，出现“权限被拒绝”错误~/.cache/uv或~/.local/share/uv（在受管/公司计算机上很常见），添加envblock重定向两条路径： ``json { "mcpServers": { "DocumentBrain": { "command": "uvx", "args": ["vvin-document-brain"], "env": { "UV_CACHE_DIR": "/tmp/cache/uv", "XDG_DATA_HOME": "/tmp/uv-data" } } } }``
使用pip install（如果已全局安装）：
{
"mcpServers": {
"DocumentBrain": {
"command": "vvin-document-brain"
}
}
}在Claude桌面中配置
添加以下内容 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"DocumentBrain": {
"command": "uvx",
"args": ["vvin-document-brain"]
}
}
}工具使用示例
阅读文档：
Tool: read_any_document
Arguments: { "file_path": "~/Documents/report.pdf" }保存文件：
Tool: save_file_to_pc
Arguments: { "filepath": "/path/to/output.txt", "content": "Hello, world!" }项目结构
DocumentBrain/
├── src/
│ └── document_brain/
│ ├── __init__.py
│ └── server.py # MCP server with tools, resources, and prompts
├── tests/
│ └── test_server.py
├── pyproject.toml
└── README.md支持的文件格式
DocumentBrain利用MarkItDown转换各种文件格式，包括：
- Word文档（.docx）
- Excel电子表格（.xlsx）
- PowerPoint演示文稿（.pptx）
- 图像（带OCR）
- 超文本标记语言
- 纯文本
- 更多（参见 Markitdown文档 完整列表）
发展
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest许可证
麻省理工学院
作者
维什韦什·文丘卡vishwesh.vinchurkar@gmail.com