AI助手开发工具

一个基于Python的AI助手开发工具,支持本地文档搜索和IDE集成,适用于开发人员快速构建和部署AI助手。

  • by J0hnLem0n
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 J0hnLem0n/plasma-mcp

使用说明

下载Plasma AI Assistant

本指南解释了如何在结构重组后配置和运行项目。

先决条件

  • Python 3.10+
  • gigachat api日本语

安装和配置

  1. 克隆项目和文档存储库:

    # Клонируйте основной проект (если еще не сделали)
    git clone git@github.com:J0hnLem0n/plasma-mcp.git
    cd plasma-mcp
    
    # Клонируйте репозиторий Plasma (для документации)
    git clone https://github.com/salute-developers/plasma.git plasma_repo
    
  2. 创建虚拟环境:

    python3 -m venv .venv
    source .venv/bin/activate  # для macOS/Linux
    
  3. 建立依赖关系:

    pip install -e .
    
  4. 配置 .env: 所有路径都必须明确指定。创建文件 .env 在项目的根:

    GIGACHAT_CREDENTIALS='ваш_авторизационный_ключ'
    GIGACHAT_SCOPE=GIGACHAT_API_CORP
    
    # Пути к данным (относительно корня проекта)
    PLASMA_REPO_PATH=plasma_repo
    PLASMA_INDEX_DIR=plasma_index
    PLASMA_DOCS_PATH=website/sdds-platform-ai-docs/docs
    

启动组件

1.AI代理(CLI)

代理是终端中使用本地文档搜索的聊天机器人。

[!注意] 第一次运行代理或服务器时,将自动在文件夹中创建搜索索引。 plasma_index可能需要几秒钟。

python -m src.agent

2.MCP服务器(流式HTTP)

该服务器允许您将等离子体知识连接到Cursor、Claude Desktop和其他IDE。

python -m src.server

启动时,服务器将显示: 🔗 URL для подключения: http://127.0.0.1:8000/mcp

连接到IDE

光标

  1. 转到 设置->光标设置->通用->MCP.
  2. 点击 +添加新的MCP服务器.
  3. 选择类型 上海证券交易所 (或HTTP,如果支持)。
  4. 指定URL: http://127.0.0.1:8000/mcp.

MCP Inspector(MCP Inspector)

确保服务器正常运行:

npx @modelcontextprotocol/inspector --transport http --server-url http://127.0.0.1:8000/mcp

内核测试

要检查手动搜索(无需启动服务器):

python verify.py