autocode-mcp 0.1.0__tar.gz

autocode_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,70 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv sync --all-extras
+      - run: uv run ruff check .
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv sync --all-extras
+      - run: uv run mypy src/
+
+  test-unit:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.14"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv sync --all-extras
+      - run: uv run pytest tests/ -v -m "not integration" --cov --cov-report=xml
+      - uses: codecov/codecov-action@v4
+        if: matrix.os == 'ubuntu-latest'
+        with:
+          files: coverage.xml
+          flags: unit-tests
+
+  test-integration:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+      - run: uv sync --all-extras
+      - run: uv run pytest tests/ -v -m "integration"

autocode_mcp-0.1.0/.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+coverage.xml
+*.cover
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Linting
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Project specific
+*.exe
+*.out
+*.o
+.tmp/
+
+# OS
+.DS_Store
+Thumbs.db

autocode_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-03-31
+
+### Features
+
+- 完成 Interactor 完整验证逻辑，实现真实的交互测试
+- 添加 compiler.py 单元测试（14 个测试用例）
+- 创建平台工具模块 `platform.py`，消除 `exe_ext` 判断的代码重复
+- 拆分 `StressTestRunTool.execute` 函数，提高代码可读性
+
+### Improvements
+
+- 测试代码覆盖从约 50-60% 提升至 80%+
+- 消除 10 处 `exe_ext` 重复代码
+- 通过工具函数封装提高可维护性
+
+### Code Quality
+
+- 将平台相关逻辑集中到 `platform.py` 模块
+- 重构过长函数，拆分为更小的辅助方法
+- 更新类型注解和导入声明
+
+### Breaking Changes
+
+- 无
+
+## [0.1.0] - 2025-03-30
+
+### Features
+
+- 初始化 AutoCode MCP Server 基础架构
+- 实现 14 个原子工具：
+  - File 工具组：`file_read`, `file_save`
+  - Solution 工具组：`solution_build`, `solution_run`
+  - Stress Test 工具组：`stress_test_run`
+  - Problem 工具组：`problem_create`, `problem_generate_tests`, `problem_pack_polygon`
+  - Validator 工具组：`validator_build`, `validator_select`
+  - Generator 工具组：`generator_build`, `generator_run`
+  - Checker 工具组：`checker_build`
+  - Interactor 工具组：`interactor_build`
+- 添加 testlib.h 和 C++ 代码模板
+- 实现 MCP Resources 和 Prompts
+- 添加 51 个测试用例
+
+### Design Rationale
+
+- **纯工具模式**：Server 不调用任何 LLM，由 Client 提供智能编排
+- **无状态设计**：每次调用独立，状态由 `problem_dir` 参数管理
+- **统一返回格式**：`{success, error, data}`
+
+### Notes & Caveats
+
+- Windows 平台不支持内存限制（ulimit）
+- 需要 g++ 编译器支持 C++2c 标准

autocode_mcp-0.1.0/CLAUDE.md

@@ -0,0 +1,74 @@
+# CLAUDE.md
+
+此文件为 Claude Code (claude.ai/code) 在此代码仓库中工作时提供指导。
+
+## 项目概述
+
+AutoCode MCP Server 是基于论文《AutoCode: LLMs as Problem Setters for Competitive Programming》实现的竞赛编程出题辅助工具，提供 Validator-Generator-Checker 框架。
+
+## 开发命令
+
+```bash
+# 安装依赖
+uv sync
+
+# 运行测试
+uv run pytest tests/ -v
+
+# 代码检查
+uv run ruff check .
+
+# 类型检查
+uv run mypy src/
+
+# 运行 MCP Server
+uv run autocode-mcp
+```
+
+## 项目结构
+
+```
+AutoCode/
+├── src/autocode_mcp/     # 源代码
+│   ├── tools/            # MCP 工具实现
+│   ├── resources/        # 模板资源
+│   ├── prompts/          # 工作流提示词
+│   └── utils/            # 工具函数
+├── tests/                # 测试用例
+├── templates/            # C++ 模板文件 (testlib.h 等)
+└── pyproject.toml        # 项目配置
+```
+
+## 工具列表
+
+| 工具 | 描述 |
+|------|------|
+| FileSaveTool | 保存文件 |
+| FileReadTool | 读取文件 |
+| FileListTool | 列出文件 |
+| SolutionBuildTool | 构建解法 |
+| SolutionTestTool | 测试解法 |
+| StressTestTool | 压力测试 |
+| ProblemInitTool | 初始化题目 |
+| ProblemGenerateTestsTool | 生成测试数据 |
+| ValidatorBuildTool | 构建校验器 |
+| ValidatorSelectTool | 选择最佳校验器 |
+| GeneratorBuildTool | 构建生成器 |
+| GeneratorRunTool | 运行生成器 |
+| CheckerBuildTool | 构建检查器 |
+| InteractorBuildTool | 构建交互器 |
+
+## 出题工作流程
+
+1. 初始化题目目录 (`ProblemInitTool`)
+2. 实现解法 (`SolutionBuildTool`)
+3. 构建校验器 (`ValidatorBuildTool`)
+4. 构建生成器 (`GeneratorBuildTool`)
+5. 运行压力测试 (`StressTestTool`)
+6. 生成测试数据 (`ProblemGenerateTestsTool`)
+
+## 关键约束
+
+- 包管理强制使用 `uv`（绝对禁用 pip/poetry/conda）
+- 运行时强制使用 `uv run`
+- C++ 标准使用 C++2c

autocode_mcp-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# 贡献指南 (Contributing to AutoCode)
+
+由于 AutoCode 是一个旨在产出自动化高质量竞赛题目的辅助工具和 SOP 集合，我们非常珍惜所有形式的建议和改进。
+
+## 提交 Issue
+
+如果您发现了对拍脚本的 Bug、需要改进 SOP（Agent Prompt），请向我们**提交 Issue**，描述清楚：
+
+1.  您所使用的环境（OS 及其版本、Python 版本等）。
+2.  出现的具体问题（带上完整的报错日志）。
+3.  您期望看到的结果。
+
+## 提交 Pull Request
+
+1.  **Fork 本仓库** 到您的账号下。
+2.  新建一个分支用于您的修改：`git checkout -b feature/your-feature-name` 或 `fix/your-bugfix-name`。
+3.  确保您的代码符合本指南和已有的风格规范。如果添加了 Python 脚本用于 Agent 或工具流程，请**确保在独立的 `uv` 环境下进行了良好测试**。
+4.  提交您的修改。提交信息（Commit Message）需要尽量清晰明了。
+5.  创建一个指向本仓库的 Pull Request。
+
+## 开发规范提示
+
+1.  **全局环境**：避免全局安装任何开发依赖，请使用项目内的独立虚拟隔离环境执行相关 Python 程序，并使用 `uv` 统一管理。
+2.  **文件编码**：涉及 Windows 命令执行或文件生成的脚本时，请务必保证以 UTF-8 或相应无乱码编码执行。
+3.  **遵循 SOP**：如果是针对核心 Agent Prompt 或 SOP 交互进行的改动，建议在拉取请求中附带通过跑通至少一次完整示例题型测试的运行截图。

autocode_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Developer/Organiation Name]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

autocode_mcp-0.1.0/Makefile

@@ -0,0 +1,49 @@
+.PHONY: $(MAKECMDGOALS)
+
+# 默认目标
+help:
+	@echo "Available targets:"
+	@echo "  setup        - 安装依赖"
+	@echo "  test         - 运行测试"
+	@echo "  test-cov     - 运行测试并生成覆盖率报告"
+	@echo "  lint         - 运行 ruff lint 检查"
+	@echo "  format       - 格式化代码"
+	@echo "  typecheck    - 运行 mypy 类型检查"
+	@echo "  check        - 运行所有检查 (lint + typecheck + test)"
+	@echo "  clean        - 清理缓存和临时文件"
+	@echo "  docs         - 启动文档服务器"
+
+# 安装依赖
+setup:
+	uv sync --all-extras
+
+# 运行测试
+test:
+	uv run pytest tests/ -v
+
+# 运行测试并生成覆盖率报告
+test-cov:
+	uv run pytest tests/ --cov=src/autocode_mcp --cov-report=html --cov-report=term
+
+# 运行 ruff lint 检查
+lint:
+	uv run ruff check src/ tests/
+
+# 格式化代码
+format:
+	uv run ruff format src/ tests/
+
+# 运行 mypy 类型检查
+typecheck:
+	uv run mypy src/
+
+# 运行所有检查
+check: lint typecheck test
+
+# 清理缓存和临时文件（跨平台兼容）
+clean:
+	uv run python -c "import shutil, pathlib; [shutil.rmtree(p, ignore_errors=True) for p in pathlib.Path('.').rglob('__pycache__')]; [shutil.rmtree(p, ignore_errors=True) for p in ['.pytest_cache', '.mypy_cache', '.ruff_cache', 'htmlcov', '.coverage'] if pathlib.Path(p).exists()]"
+
+# 启动文档服务器 (如果有 mkdocs)
+docs:
+	uv run mkdocs serve