本项目是一个基于Model Context Protocol (MCP) 的服务器端应用,旨在为大型语言模型(LLM)客户端提供访问巴西法律信息(特别是Superior Tribunal de Justiça - STJ 的法律判例)的能力。它将复杂的网络爬取和数据结构化过程封装为一个标准的MCP工具,使得LLM可以通过调用该工具,方便快捷地进行巴西法律研究。

主要功能点

  • STJ法律判例查询工具: 提供一个名为 'precedentes-stj' 的工具,允许用户通过指定搜索条件(如判例摘要中的关键词、逻辑运算符等)来检索STJ的法律判例。
  • 标准化接口: 通过MCP协议提供统一的JSON-RPC接口,便于各类支持MCP的LLM客户端集成和使用。

安装步骤

  1. 克隆仓库: 打开终端,执行以下命令克隆项目代码:
    git clone https://github.com/pdmtt/brlaw_mcp_server.git
  2. 安装依赖: 进入项目目录,使用 'uv'(推荐)或 'pip' 安装所需依赖。需要 Python 3.11 或更高版本。
    # 使用 uv (推荐),根据项目README执行命令
    uv run patchright install
    # 或者使用 pip 安装核心依赖(如果uv不行)
    # pip install mcp patchright pydantic
    同时,确保您的系统已安装 Google Chrome 浏览器,因为该工具依赖于它进行网页抓取。

MCP服务器配置

本项目是一个MCP服务器,需要由支持MCP协议的LLM客户端启动和连接。您需要在您的MCP客户端配置中添加如下服务器信息(请根据您的客户端具体要求调整格式,以下是一个示例JSON结构):

{
  "mcpServers": {
    "brlaw_mcp_server": { // 服务器的唯一标识名
      "command": "uv", // 启动服务器的命令
      "args": [
        "--directory",
        "/<path>/brlaw_mcp_server", // **请将此路径替换为项目实际所在的目录**
        "run",
        "serve" // 启动服务器主程序的命令参数
      ]
    }
  }
}

配置完成后,您的MCP客户端应能检测到名为 'brlaw_mcp_server' 的服务器并尝试连接。

基本使用方法

连接成功后,LLM客户端将可以通过MCP协议与本服务器交互。LLM可以:

  • 获取服务器提供的工具列表(如 'precedentes-stj' 工具)。
  • 调用 'precedentes-stj' 工具,并提供查询参数(即 'summary' 字段,一个字符串,包含要搜索的关键词和逻辑/proximity运算符,详细语法请参考工具描述)。
  • 接收工具执行结果。对于 'precedentes-stj' 工具,返回的结果是一个包含多个法律判例摘要的列表,每个判例摘要以 JSON 格式表示。

LLM可以利用检索到的判例摘要进行分析、总结或回答与巴西法律相关的问题。

信息

分类

AI与计算