Case Chronology MCP Server

案件时间线 MCP 服务

一个用于构建和管理案件事件时间线的 Model Context Protocol（MCP）服务。非常适合法律专业人士整理复杂的案件历史。

功能

• 智能日期解析：支持多种日期格式，包括确切日期、近似日期、月份和季度
• 文档解析：自动从粘贴的文档中提取日期和事件
• 多格式导出：生成 Markdown、CSV、简短文本或 JSON 格式的时间线
• 高级搜索：按日期范围、当事方、关键词或标签查询
• 当事方和文档索引：按相关当事方或来源文档快速查找

安装

选项 1：使用 uvx（推荐）

无需安装！可直接使用 uvx 运行该服务。

选项 2：传统安装

1. 克隆此仓库：

git clone https://github.com/medelman17/case-chronology-mcp.git
cd case-chronology-mcp

2. 使用 uv 安装：

uv pip install -e .

或使用 pip：

pip install -r requirements.txt

配置

将此服务添加到 Claude Desktop 配置中：

Windows 用户 — 分步指南

步骤 1：下载并设置

1. 打开 PowerShell 或 命令提示符
2. 导航到你想要安装的位置（例如，你的 GitHub 文件夹）：

   cd C:\Users\%USERNAME%\GitHub
   

3. 克隆此仓库：

   git clone https://github.com/medelman17/case-chronology-mcp.git
   cd case-chronology-mcp
   

4. **重要：**运行设置脚本（此脚本会创建虚拟环境并安装依赖项）：

   .\setup.bat
   

   等待脚本运行完成。结束时应显示“Setup complete!”。

步骤 2：配置 Claude Desktop

1. 打开 Claude Desktop
2. 前往 Settings（左下角的齿轮图标）
3. 点击 Developer 选项卡
4. 找到 MCP Servers Configuration 部分
5. 添加此配置（将 %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"
    }
  }
}

6. 保存配置
7. 重启 Claude Desktop

步骤 3：测试是否正常运行

重启 Claude Desktop 后，你应该能看到 Case Chronology 服务已连接。试着询问：

“添加一个事件：2024 年 1 月 15 日 — ABC Corp 与 XYZ LLC 签署合同”

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 月的所有事件”
• “查找涉及 Smith 的事件”
• “搜索标记为 ‘breach’ 的事件”
• “显示 2023 年 1 月 1 日至 2023 年 6 月 30 日之间的事件”

导出

• “将时间线导出为 markdown”
• “给我一个简短的时间线”
• “导出为适用于 Excel 的 CSV”
• “导出完整的 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）

❌ “Virtual environment not found” 错误

• 确保先运行了 .\setup.bat
• 检查项目目录中是否存在 venv 文件夹

❌ “Python not found” 错误

• 从 python.org 安装 Python 3.10 或更高版本
• 安装时务必勾选“Add Python to PATH”

❌ “Setup failed” 错误

• 尝试以管理员身份运行 PowerShell
• 或手动创建环境：

  python -m venv venv
  venv\Scripts\activate
  pip install -r requirements.txt
  

❌ 服务立即断开连接

• 检查 Claude Desktop 配置中的路径是否正确
• 确保在 JSON 路径中使用双反斜杠（\\）
• 确认路径中的用户名正确

❌ “Permission denied” 错误

• 以管理员身份运行 PowerShell
• 或尝试安装到其他位置（例如“文档”文件夹）

测试

使用 MCP Inspector 测试服务：

npx @modelcontextprotocol/inspector python chronology_server.py

可用工具

• add_event - 向时间线添加单个事件
• parse_document - 从文档文本中提取事件
• search_timeline - 按不同条件搜索事件
• get_timeline_summary - 获取概览统计信息
• export_chronology - 以不同格式导出
• update_event - 修改现有事件
• delete_event - 从时间线中删除事件

许可证

MIT