返回 MCP 目录
public公开dns本地运行

aicompliance_mcp

一个关于欧盟AI法案的问答聊天机器人项目,采用混合检索方法(向量搜索+知识图谱),提供本地运行和AWS Lambda部署方案。

article

README

🚀 欧盟人工智能法案合规聊天机器人

这是一个专为解答欧盟《人工智能法案》相关问题而设计的聊天机器人。它运用了混合检索方法,结合向量搜索与知识图谱技术,能精准高效地给出答案。

🚀 快速开始

该聊天机器人可帮助用户解答欧盟《人工智能法案》的相关问题,你可以按照以下步骤进行操作。

📦 安装指南

  1. 安装 Poetry:若尚未安装 Poetry,请依照此处的说明完成安装。
  2. 克隆仓库
    git clone <your-repo-url>
    cd eu-ai-act-chatbot
    
  3. 安装依赖项
    poetry install
    
  4. 设置环境变量
    • .env.example 文件复制为 .env
      cp .env .env # 或将模板重命名为 .env
      
    • .env 文件中填写您的 API 密钥和服务详细信息。
  5. 下载欧盟《人工智能法案》PDF:把 PDF 文件放置在 data/ 目录下(若该目录不存在则需创建),文件名设为 eu_ai_act.pdf

💻 使用示例

处理数据

若要处理欧盟《人工智能法案》文档并填充向量存储和知识图谱,可执行以下命令:

poetry shell
python -m scripts.process_eu_ai_act

运行 API

若要在本地运行 FastAPI 应用程序,可执行以下命令:

poetry shell
uvicorn src.eu_ai_act_chatbot.api.main:app --reload

API 将在 http://127.0.0.1:8000 可用。您可以在 http://127.0.0.1:8000/docs 访问交互式文档。

运行测试

执行以下命令来运行测试:

poetry shell
pytest

部署(AWS Lambda)

  1. 创建部署包
    # 确保依赖项在项目虚拟环境中安装
    poetry install --no-dev
    
    # 创建包装目录
    mkdir package
    
    # 将依赖项安装到包装目录中
    poetry run pip install --upgrade pip
    poetry run pip install -r <(poetry export -f requirements.txt --without-hashes) --target ./package
    
    # 复制源代码和 Lambda 处理程序
    cp -r ./src ./package/
    cp lambda_function.py ./package/
    
    # 创建 zip 文件
    cd package
    zip -r ../deployment.zip .
    cd ..
    
  2. 上传 deployment.zip 到您的 AWS Lambda 函数。
  3. 确保 Lambda 函数的处理程序设置为 lambda_function.lambda_handler
  4. 在 Lambda 函数设置中配置必要的环境变量。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端