ChemAnim

중국어 화학 애니메이션 요구사항을 검증 가능한 Manim 장면으로 변환합니다: DeepSeek가 요구사항을 이해하고 영어 표준 이름과 후보 isomeric SMILES를 제공합니다; 프로그램은 PubChem을 조회하고 Morgan 지문으로 후보 구조를 비교하며, 데이터베이스 구조를 사용하고 RDKit이 분자식, 형식 전하 및 방정식 보존을 검증합니다. Manim은 최종 JSON만 읽고 모델이 생성한 코드는 실행하지 않습니다.

준비

Python 3.12와 DeepSeek API 키가 필요합니다. 방정식은 Unicode 화학 아래첨자로 표시되며 더 이상 MiKTeX에 의존하지 않습니다. 최초 설치:

cd C:\Users\i\Documents\chemenv
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

키를 소스 코드나 .env에 작성하지 마십시오. 현재 PowerShell 세션에서 설정:

$secureKey = Read-Host "DeepSeek API Key" -AsSecureString
$env:DEEPSEEK_API_KEY = [Net.NetworkCredential]::new("", $secureKey).Password

새 터미널에서도 유지하려면 Windows 사용자 환경 변수에 DEEPSEEK_API_KEY를 추가한 후 PowerShell을 다시 여십시오. 환경 확인:

.\check_environment.ps1

Related MCP server: ChemCP

사용

먼저 장면, 구조도 및 검증 보고서만 생성하고 확인합니다:

.\.venv\Scripts\chemanim.exe "演示乙烯与溴的加成反应。生成物为1,2-二溴乙烷，展示所有物质的结构式。" --no-render

2D 또는 3D 애니메이션을 렌더링합니다:

.\.venv\Scripts\chemanim.exe "演示乙烯与溴的加成反应。生成物为1,2-二溴乙烷。" --quality high
.\.venv\Scripts\chemanim.exe "演示乙烯与溴的加成反应。生成物为1,2-二溴乙烷。" --quality high --structure-mode 3d

--structure-mode 3d는 기본적으로 OpenGL/GPU를 자동으로 활성화합니다; 2D 구조는 기본적으로 더 호환성이 높은 Cairo를 사용합니다. 빠른 미리보기에는 --quality medium을 권장하며, 수동으로 선택해야 할 때는 --renderer opengl 또는 --renderer cairo를 추가할 수 있습니다.

2D 모드에서는 같은 화면의 구조식이 축척을 공유하므로, 작은 분자가 더 이상 복잡한 분자와 동일한 너비로 강제 확대되지 않습니다.

출력 위치:

• build/scene.json: 최종 장면 및 검증 요약

• build/verification.json: PubChem CID, InChIKey, 후보/검증 SMILES 및 Morgan Tanimoto 유사도

• build/molecule_*.svg 또는 장면의 3D 원자/결합 데이터

• media/: Manim 비디오

프로세스는 DeepSeek JSON이 유효하지 않을 때 최대 3회 자동으로 재전송하여 수정합니다. PubChem을 일시적으로 사용할 수 없으면 후보 구조를 유지하고 로컬 RDKit 검증을 수행합니다; 검증을 통과하지 못하면 중지하고 잘못된 결과를 렌더링하지 않습니다.

기본적으로 응답이 더 빠른 deepseek-v4-flash를 사용하며, 화학 구조는 여전히 PubChem과 RDKit이 검증합니다. 더 강력한 계획이 필요할 때는 --model deepseek-v4-pro --request-timeout 180을 추가할 수 있습니다.

더 많은 예시

.\.venv\Scripts\chemanim.exe "演示甲苯被氧气选择性氧化为苯甲醛和水，展示全部结构式。" --quality medium
.\.venv\Scripts\chemanim.exe "制作阿莫西林半合成原理动画，保持正确立体化学，不要虚构实验条件。" --no-render

MCP 서버

프로젝트는 표준 stdio MCP 진입점을 제공합니다:

.\.venv\Scripts\chemanim-mcp.exe

MCP 클라이언트 구성 예시(키는 클라이언트 프로세스에서 상속되며 JSON에 작성하지 마십시오):

{
  "mcpServers": {
    "chemanim": {
      "command": "C:\\Users\\i\\Documents\\chemenv\\.venv\\Scripts\\chemanim-mcp.exe"
    }
  }
}

서버는 generate_chemistry_animation 도구를 노출하며, 매개변수에는 prompt, quality, structure_mode, render, model 및 request_timeout이 포함됩니다. 제약된 ChemAnim CLI만 호출하며 모델이 제출한 Python 코드는 실행하지 않습니다.