@@ -22,7 +22,7 @@ AutoCode MCP Server 提供 15 个原子工具,让 AI 助手能够创建、验
2222
2323## 安装
2424
25- ### Claude Code 插件安装 (推荐)
25+ ### 1. Claude Code 市场安装 (推荐)
2626
2727本仓库已经按官方 Claude Code plugin 结构组织:
2828
@@ -39,27 +39,30 @@ AutoCode MCP Server 提供 15 个原子工具,让 AI 助手能够创建、验
3939- AutoCode 工作流 skill
4040- 用于阻止跳步的 hooks
4141
42- 如果你要做个人第三方 marketplace,可直接使用同级仓库 ` ../autocode-marketplace ` 。它默认走 GitHub 远程安装,不需要上官方市场。
43-
44- 如果当前环境不走 Claude Code 插件安装,也可以直接在 Claude Code 中添加 MCP server:
42+ 推荐通过 Claude Code marketplace 安装,这样会同时安装 plugin manifest、agent、skills 和 workflow hooks。
4543
4644``` bash
47- claude mcp add autocode -- uvx autocode-mcp
45+ claude plugin marketplace add https://github.com/SummerOneTwo/autocode-marketplace.git
46+ claude plugin install autocode@autocode-marketplace
4847```
4948
50- ### 从 PyPI 安装(推荐)
49+ 注意:marketplace 默认从 ` https://github.com/SummerOneTwo/AutoCode.git ` 远程安装,所以测试远程安装前需要先把插件改动 push 到 GitHub。
50+
51+ ### 2. 从 PyPI 安装
5152
5253``` bash
5354pip install autocode-mcp
5455```
5556
56- ### 使用 uv 安装
57+ ### 3. 其它通用安装方式
58+
59+ #### 使用 uv 安装
5760
5861``` bash
5962uv tool install autocode-mcp
6063```
6164
62- ### 从源码安装
65+ #### 从源码安装
6366
6467``` bash
6568git clone https://github.com/SummerOneTwo/AutoCode.git
@@ -90,36 +93,14 @@ uv run pytest tests/ -v
9093
9194### 1. 安装插件
9295
93- 推荐方式:
94-
95- - 以 Claude Code plugin 方式安装本仓库。
96- - 本地开发时可用 ` claude --plugin-dir . ` 测试插件行为。
97- - 如果走个人 marketplace,可直接执行:
96+ 推荐直接通过 Claude Code marketplace 安装:
9897
9998``` bash
100- claude plugin marketplace add ../ autocode-marketplace
99+ claude plugin marketplace add https://github.com/SummerOneTwo/ autocode-marketplace.git
101100claude plugin install autocode@autocode-marketplace
102101```
103102
104- 注意:marketplace 默认从 ` SummerOneTwo/AutoCode ` 远程安装,所以测试远程安装前需要先把插件改动推到 GitHub。
105-
106- 直接接入 Claude Code 的备用方式:
107-
108- ``` bash
109- claude mcp add autocode -- uvx autocode-mcp
110- ```
111-
112- 项目级备用方式:
113-
114- ``` json
115- {
116- "mcpServers" : {
117- "autocode" : {
118- "command" : " autocode-mcp"
119- }
120- }
121- }
122- ```
103+ 如果你只是想把 MCP server 作为通用组件使用,再选择 PyPI、` uv ` 或源码安装。
123104
124105### 2. 创建你的第一个题目
125106
@@ -134,22 +115,6 @@ Claude 将使用 AutoCode 工具:
1341154 . 运行压力测试
1351165 . 生成最终测试数据
136117
137- ### 3. 手动调用工具
138-
139- 你也可以直接调用工具:
140-
141- ``` python
142- # 构建解法
143- solution_build(
144- problem_dir = " problems/ab" ,
145- solution_type = " sol" ,
146- code = " #include <iostream>\n int main() { int a, b; std::cin >> a >> b; std::cout << a + b; }"
147- )
148-
149- # 运行压力测试
150- stress_test_run(problem_dir = " problems/ab" , trials = 100 )
151- ```
152-
153118## 客户端配置
154119
155120### 传输层与兼容性
@@ -158,11 +123,11 @@ stress_test_run(problem_dir="problems/ab", trials=100)
158123
159124** 当前支持** :仅支持本地 stdio 传输。服务器通过标准输入/输出流通信,适用于本地可信环境。
160125
161- | 客户端 | 状态 | 说明 |
162- | --------| ------ | ------ |
163- | Claude Code | ✅ 已验证 | 主要开发环境 |
164- | Cursor | ⚠️ 配置已提供 | 尚未端到端测试 |
165- | OpenCode | ⚠️ 配置已提供 | 尚未端到端测试 |
126+ | 客户端 |
127+ | --------|
128+ | Claude Code |
129+ | Cursor |
130+ | OpenCode |
166131
167132** 不支持** :HTTP/SSE 传输、远程连接或多租户环境。
168133
@@ -176,23 +141,6 @@ stress_test_run(problem_dir="problems/ab", trials=100)
176141- [ ` hooks/hooks.json ` ] ( hooks/hooks.json )
177142- [ ` scripts/workflow_guard.py ` ] ( scripts/workflow_guard.py )
178143
179- 直接 MCP 接入的备用方式:
180-
181- ``` bash
182- claude mcp add autocode -- uvx autocode-mcp
183- ```
184-
185- 手动配置方式:
186-
187- ``` json
188- {
189- "mcpServers" : {
190- "autocode" : {
191- "command" : " autocode-mcp"
192- }
193- }
194- }
195- ```
196144
197145### 其他 MCP 客户端
198146
@@ -218,21 +166,6 @@ claude mcp add autocode -- uvx autocode-mcp
218166
219167编辑 ` ~/.config/opencode/opencode.json ` :
220168
221- ``` json
222- {
223- "$schema" : " https://opencode.ai/config.json" ,
224- "mcp" : {
225- "autocode" : {
226- "type" : " local" ,
227- "command" : [" autocode-mcp" ],
228- "enabled" : true
229- }
230- }
231- }
232- ```
233-
234- 或使用 ` uvx ` 无需预安装:
235-
236169``` json
237170{
238171 "$schema" : " https://opencode.ai/config.json" ,
@@ -246,21 +179,6 @@ claude mcp add autocode -- uvx autocode-mcp
246179}
247180```
248181
249- ### 从源码运行(开发模式)
250-
251- 用于开发或自定义安装:
252-
253- ``` json
254- {
255- "mcpServers" : {
256- "autocode" : {
257- "command" : " uv" ,
258- "args" : [" run" , " --directory" , " /path/to/autocode-mcp" , " autocode-mcp" ]
259- }
260- }
261- }
262- ```
263-
264182### 验证安装
265183
266184配置完成后,重启 MCP 客户端并检查工具是否可用。你应该能看到 15 个工具,包括 ` solution_build ` 、` validator_build ` 、` generator_build ` 等。
0 commit comments