法律工作区MCP服务器
一个MCP（模型上下文协议）服务器，为Claude提供 自我更新访问 到本地文档目录（模板、文章、意见、起草指南等），以便在回答问题时自动引用它们。
专为法律专业人士打造，但与 任何文件收藏.
运作原理
- 你把它指向一个目录 包含您的文档（PDF、DOCX、Markdown、HTML、TXT等）。
- 它索引了所有内容 使用TF-IDF进行快速、相关的搜索。
- 它观察变化 --添加、编辑或删除文件，索引会自动更新。
- 克劳德将其用作上下文 --当你问问题时，克劳德可以搜索你的文档，并提取最相关的段落，而无需你上传任何内容。
安装
需求要求 规格 ：必须指定目标目录。服务器监视
一次一个目录
pip install legal-workspace-mcp（包括所有子目录）。要更改目录，请使用其他路径重新注册服务器。
pip install git+https://github.com/gwicho38/legal-workspace-mcp.git选项A：从PyPI安装（推荐）
uvx legal-workspace-mcp /path/to/your/documents选项B：从GitHub安装
git clone https://github.com/gwicho38/legal-workspace-mcp.git
cd legal-workspace-mcp
pip install -e .选项C：不安装就运行（uvx）
选项D：克隆并在本地安装
claude mcp add legal-workspace -- legal-workspace-mcp /path/to/your/documents设置 claude 克劳德代码（CLI）
就是这样。服务器会自动启动会议。
claude mcp remove legal-workspace
claude mcp add legal-workspace -- legal-workspace-mcp /new/path/to/documents更改目标目录
，删除并重新添加：
克劳德桌面 将此添加到您的Claude Desktop配置文件中： |操作系统|配置路径| ~/Library/Application Support/Claude/claude_desktop_config.json |----|-------------| |macOS| %APPDATA%\Claude\claude_desktop_config.json | |窗户| ~/.config/Claude/claude_desktop_config.json |
{
"mcpServers": {
"legal-workspace": {
"command": "legal-workspace-mcp",
"args": ["/path/to/your/documents"]
}
}
}|Linux|
|
export LEGAL_WORKSPACE_PATH="/path/to/your/documents"备选方案：环境变量
与其将路径作为参数传递： 目录管理 服务器监视
正好一个目录
（递归）每个实例。以下是目录配置的工作原理：
指定目录（必需） 目标目录在启动时以以下优先级解析： |优先级|方法|示例| legal-workspace-mcp /path/to/docs |----------|--------|---------| |1（最高）|CLI参数| LEGAL_WORKSPACE_PATH=/path/to/docs | |2|环境变量| ~/.legal-workspace-mcp.json |
|3|配置文件|
|
- 如果没有配置目录，服务器将退出并显示错误——它不会默认为一个目录。
- 什么会被索引
- 目标目录和所有子目录中与支持的扩展名（见下文）匹配的所有文件
.符号链接会自动解析 - 隐藏文件（以开头
.git)被跳过__pycache__默认情况下，某些目录被排除在外：node_modules,.venv,venv
,
,
# Claude Code
claude mcp remove legal-workspace
claude mcp add legal-workspace -- legal-workspace-mcp /new/path
# Claude Desktop
# Edit the config JSON file and change the path in "args"更改目标目录.legal_workspace_index.json由于服务器是由Claude作为子进程启动的，因此您可以通过更新MCP注册来更改目录：
旧索引保留在监视的目录中(
).当您指向一个新目录时，会自动构建一个新的索引。 实时更新 服务器使用
看门狗 以监视目录。更改将自动处理：
| 行动 | 行为 |
|---|---|
| 添加文件 | 在约2秒内索引 |
| 编辑文件 | 用新内容重新索引 |
|删除文件|从索引中删除|
|重命名文件|删除旧条目，索引新条目|
更改会被取消（2秒安静期），以避免在活动编辑过程中出现抖动。 .legal-workspace-mcp.json 可选微调
{
"chunk_size": 1500,
"chunk_overlap": 200,
"max_results": 10,
"excluded_dirs": [".git", "__pycache__", "node_modules", "archive"],
"excluded_patterns": [".*"]
}地点a 目标目录中的文件： |设置|默认值|说明| chunk_size |---------|---------|-------------| | chunk_overlap |1500个字符/块用于索引| | max_results |200|块之间重叠以保留上下文| | excluded_dirs |10|默认最大搜索结果| [".git", ...] | | excluded_patterns |要跳过的目录| [".*"] |
|
|要跳过的文件模式|
可用工具 配置后，Claude可以访问这些工具： |工具|说明| workspace_search |------|-------------| | workspace_get_document |按主题或关键字搜索所有文档中的相关内容| | workspace_list_documents |检索特定文档的全文| | workspace_status |列出工作区中的所有索引文档| | workspace_reindex |检查索引运行状况、文档计数和观察者状态|
|
|强制进行完整的重新索引（很少需要）| 支持的文件类型 |格式|扩展名| .txt|--------|------------| .md|纯文本| .markdown , , .pdf | |PDF| .docx | |Word| .html| .htm |HTML| , .rtf |
|富文本|
|
- *示例用法*
- *一旦设置好，问克劳德一些事情，比如：*
- *使用模板中的样式为软件许可协议起草赔偿条款*
- *“我的参考文章对新冠肺炎后的不可抗力条款有什么看法？”*
“帮我修改这份竞业禁止协议——查看我的起草指南，了解最佳实践。”
“比较我拥有的保密协议模板，并为双方保密协议推荐最佳模板。”
Claude (Desktop / Code / API)
│
▼ stdio transport
Legal Workspace MCP Server
├── FastMCP (tool definitions)
├── Document Index (TF-IDF + chunks)
├── Watchdog (filesystem monitoring)
└── Text Extractors (PDF, DOCX, MD, HTML)
│
▼
Your Document Directory
├── templates/
├── articles/
└── opinions/Claude将自动搜索您的工作区文档并合并相关上下文。
git clone https://github.com/gwicho38/legal-workspace-mcp.git
cd legal-workspace-mcp
pip install -e .
# Run directly
legal-workspace-mcp /path/to/test/documents
# Test with MCP Inspector
npx @modelcontextprotocol/inspector legal-workspace-mcp /path/to/test/documents建筑
发展