使用说明
下载Plasma AI Assistant
本指南解释了如何在结构重组后配置和运行项目。
先决条件
- Python 3.10+
- gigachat api日本语
安装和配置
-
克隆项目和文档存储库:
# Клонируйте основной проект (если еще не сделали) git clone git@github.com:J0hnLem0n/plasma-mcp.git cd plasma-mcp # Клонируйте репозиторий Plasma (для документации) git clone https://github.com/salute-developers/plasma.git plasma_repo -
创建虚拟环境:
python3 -m venv .venv source .venv/bin/activate # для macOS/Linux -
建立依赖关系:
pip install -e . -
配置
.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
光标
- 转到 设置->光标设置->通用->MCP.
- 点击 +添加新的MCP服务器.
- 选择类型 上海证券交易所 (或HTTP,如果支持)。
- 指定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
