案例年表MCP服务器
一种模型上下文协议（MCP）服务器，用于构建和管理案例事件的时间轴。非常适合需要组织复杂案件历史的法律专业人士。
特性
- 智能日期解析：处理各种日期格式，包括精确日期、近似日期、月份和季度
- 文档分析：自动从粘贴的文档中提取日期和事件
- 多格式导出：以Markdown、CSV、简短文本或JSON格式生成时间线
- 高级搜索：按日期范围、参与方、关键字或标签查询
- 聚会和文件索引：相关方或源文件的快速查找
安装
选项1：使用uvx（推荐）
无需安装！服务器可以直接运行 uvx.
选项2：传统安装
- 克隆此存储库：
git clone https://github.com/medelman17/case-chronology-mcp.git
cd case-chronology-mcp- 使用紫外线进行安装：
uv pip install -e .或者使用pip：
pip install -r requirements.txt配置
将服务器添加到您的Claude Desktop配置中：
Windows用户-一步一步
步骤1：下载和设置
- 打开 PowerShell 或 命令提示符
- 导航到要安装的位置（例如，您的GitHub文件夹）：
cd C:\Users\%USERNAME%\GitHub- 克隆存储库：
git clone https://github.com/medelman17/case-chronology-mcp.git
cd case-chronology-mcp- 重要： 运行安装脚本（这将创建一个虚拟环境并安装依赖项）：
.\setup.bat等待它完成。您应该在最后看到“安装完成！”。
步骤2：配置Claude桌面
- 打开 克劳德桌面
- 首选 设置 （左下角的齿轮图标）
- 点击 开发者 标签
- 查找 MCP服务器配置 章节
- 添加此配置(替换
%USERNAME%使用您的实际用户名):
{
"mcpServers": {
"case-chronology": {
"command": "C:\\Users\\%USERNAME%\\GitHub\\case-chronology-mcp\\run_server.bat"
}
}
}例如，如果您的用户名是 mikee，使用：
{
"mcpServers": {
"case-chronology": {
"command": "C:\\Users\\mikee\\GitHub\\case-chronology-mcp\\run_server.bat"
}
}
}- 保存 配置
- 重新启动克劳德桌面
步骤3：测试它是否有效
重新启动Claude Desktop后，您应该看到Case Chronology服务器已连接。试着问：
“添加一个事件：2024年1月15日-ABC公司和XYZ有限责任公司签署的合同”
Mac/Linux用户
选项1：使用uvx（推荐）
{
"mcpServers": {
"case-chronology": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/medelman17/case-chronology-mcp.git",
"case-chronology-mcp"
]
}
}
}选项2：本地安装
{
"mcpServers": {
"case-chronology": {
"command": "python",
"args": ["/full/path/to/case-chronology-mcp/chronology_server.py"]
}
}
}使用示例
添加事件
简单事件：
"Add event: March 15, 2023 - Smith emails Jones about breach of contract. Parties: Smith, Jones"活动详情：
"Add event: 3/15/2023 - Contract breach notification sent. Parties: Smith, Jones. Tag: breach, notice. Significance: First formal notice of breach"文档分析
"Parse this email and add events to the chronology:
From: Bob Smith
To: Alice Jones
Date: March 15, 2023
I am writing to inform you that your failure to deliver by March 1, 2023 constitutes a breach..."搜索时间线
- “显示2023年3月的所有事件”
- “查找涉及史密斯的事件”
- “搜索标记为‘违规’的事件”
- “显示2023年1月1日至2023年6月30日期间的活动”
出口
- “将年表导出为markdown”
- “给我一个简短的时间表”
- “导出为CSV格式的Excel”
- “导出完整的JSON数据”
日期格式支持
服务器智能解析各种日期格式：
- 确切日期:
3/15/2023,March 15, 2023 - 大致日期:
early March 2023,mid March 2023,late March 2023 - 月份精度:
March 2023 - 四分之一精度:
Q1 2023 - 近似标记:
around 3/15/2023,approximately March 2023
数据存储
事件存储在 case_chronology.json 与服务器位于同一目录中。该文件在首次使用时自动创建。
故障排除（Windows）
❌ “找不到虚拟环境”错误
- 确保你跑了
.\setup.bat第一 - 检查一下
venv文件夹存在于项目目录中
❌ “找不到Python”错误
- 从以下位置安装Python 3.10或更高版本 python.org
- 确保在安装过程中选中“将Python添加到PATH”
❌ “安装失败”错误
- 尝试以管理员身份运行PowerShell
- 或者手动创建环境：
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt❌ 服务器立即断开连接
- 检查Claude Desktop配置中的路径是否正确
- 确保使用 双睫毛 (
\\)在JSON路径中 - 验证您的用户名在路径中是否正确
❌ “权限被拒绝”错误
- 以管理员身份运行PowerShell
- 或者尝试在其他位置安装（如您的Documents文件夹）
测试
使用MCP检查器测试服务器：
npx @modelcontextprotocol/inspector python chronology_server.py可用工具
add_event-将单个事件添加到年表中parse_document-从文档文本中提取事件search_timeline-按各种条件搜索事件get_timeline_summary-获取概览统计信息export_chronology-以不同格式导出update_event-修改现有事件delete_event-从时间线中删除事件
许可证
麻省理工学院