# agent-contest-java-demo

**Repository Path**: likeguo/agent-contest-java-demo

## Basic Information

- **Project Name**: agent-contest-java-demo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Contest Java Demo

[Agent Contest Java Demo](https://gitee.com/likeguo/agent-contest-java-demo)

## 项目简介

这是一个 Java 实现的竞赛 Demo 系统，用于演示 AI Agent 如何解决题目。该项目构建了一个完整的 Agent 运行时环境，支持通过 MCP（Model Context Protocol）与外部工具和技能进行交互。

## 功能特性

- **Agent 运行时**: 动态加载和执行 Agent 脚本
- **Skill 运行时**: 支持技能（Skill）模块化加载和执行
- **MCP 工具集成**: 提供标准化的工具调用接口
- **LLM 集成**: 支持多种大语言模型的聊天补全 API
- **批量处理**: 支持批量运行题目并生成结果

## 技术栈

- Java 11+
- MCP (Model Context Protocol)
- HTTP Client (用于 LLM API 调用)

## 快速开始

### 环境要求

- JDK 11 或更高版本
- Java 编译器 (javac)

### 编译运行

```bash
# 使用提供的启动脚本
./start.sh
```

或手动编译运行：

```bash
# 编译
javac -d out source/src/main/java/com/contestdemo/**/*.java

# 运行
java -cp out com.contestdemo.Main --question PATH --output OUTPUT_PATH
```

### 配置

在 `.env` 文件中配置环境变量：

```
MODEL_URL=your_model_url
API_KEY=your_api_key
MODEL=your_model
```

## 项目结构

```
.
├── source/
│   ├── src/main/java/com/contestdemo/
│   │   ├── Main.java                 # 入口类
│   │   ├── solution/
│   │   │   └── ContestantAgent.java  # 参赛者 Agent
│   │   ├── runtime/                  # 运行时核心
│   │   │   ├── AgentContext.java    # Agent 上下文
│   │   │   ├── AgentRegistry.java   # Agent 注册表
│   │   │   ├── BatchRunner.java    # 批量运行器
│   │   │   ├── ChatCompletionClient.java  # LLM 客户端
│   │   │   ├── EnvConfig.java      # 环境配置
│   │   │   ├── LocalMcpClient.java  # MCP 客户端
│   │   │   ├── SkillRuntime.java  # Skill 运行时
│   │   │   └── ...
│   │   └── toolkits/
│   │       └── MainMcp.java      # MCP 工具集
│   ├── examples/                   # 示例题目
│   └── solution/                  # 解决方案
│       ├── agents/                 # Agent 脚本
│       └── skills/                # Skill 脚本
├── start.sh                       # 启动脚本
└── .env                          # 环境配置
```

## 使用方法

### 运行单个题目

```bash
java -cp out com.contestdemo.Main --question source/examples/questions.json --output output/result.json
```

### 查看答案

```bash
java -cp out com.contestdemo.tools.ShowAnswers output/result.json
```

## License

本项目仅供演示使用。