将 Code-MCP Server 集成到 AI 代码助手中可以增强整个开发生命周期的工作流程,从简化初始代码测试和验证,到提供实时代码执行反馈。此外,它还通过安全的沙箱环境简化了复杂的代码调试和实验过程。所有这些都通过 AI 代码助手中的自然语言交互来简化复杂操作。
一、核心特性
·安全代码执行:在隔离的沙箱环境中执行多种编程语言的代码,包括 Python、JavaScript、TypeScript、R、Java。
·文件系统管理:提供完整的文件读写功能,支持在沙箱环境中创建、修改和读取文件。
·命令行执行:支持在沙箱环境中执行 Shell 命令和脚本。
·会话管理:基于会话的沙箱生命周期管理,支持长时间的交互式开发。
二、前置条件
·获取 AgentSandbox API 密钥,你的密钥仅会在第一次生成时展示,我们不会存储你的密钥,请你妥善保存你的密钥。
·创建类型为代码解释器的沙箱工具。
三、AgentSandbox API 密钥获取
要使用 Code-MCP Server,你需要获取 API 密钥:
1. 注册腾讯云账号,并完成 实名认证。
2. 在 Agent 沙箱服务 控制台中创建新的 API 密钥。
3. 记录你的 API 密钥,用于后续配置。
四、code-interpreter-v1 沙箱工具创建
1. 在 Agent沙箱服务 控制台中创建新的沙箱工具。
2. 在沙箱工具页面中,选择工具类型为“代码解释器”,单击确定创建。
五、快速开始
本快速开始指南将引导你完成配置 Code-MCP Server 的步骤,以便与 Cursor IDE 等 MCP Client 进行集成。通过这些步骤,你将设置开发环境以利用 Code-MCP Server 的工具来管理安全的代码执行环境。
六、设置 Cursor
以下 JSON 为 Cursor IDE 的配置示例,你可以将如下配置写入 Cursor IDE 的 mcp.json 配置文件中。
{ "mcpServers": { "agentsandbox-code-mcp": { "type":"streamable-http", "url": "https://mcp.your-region.tencentags.com/code?toolname=your-toolname", "headers":{ "X-API-KEY":"your-api-key" } } }}
七、工具
Code-MCP Server 提供以下工具来管理安全的代码执行环境和文件系统操作。每个工具执行特定的操作,可以被调用来自动化沙箱环境中的常见任务。
八、run_code
在安全沙箱中运行代码,使用 Jupyter 语法,在各语言的默认上下文中执行。
功能:
·支持多种编程语言:Python、JavaScript、TypeScript、R、Java、Bash。
·在隔离的沙箱环境中安全执行。
·返回标准输出和错误输出。
·支持交互式代码执行和状态保持。
参数:
·code(必需):要执行的代码字符串。
·language(可选):编程语言,默认为 "python"。
支持的语言:
·python:Python 代码执行。
·javascript:JavaScript 代码执行。
·typescript:TypeScript 代码执行。
·r:R 语言代码执行。
·java:Java 代码执行。
·bash:Bash 脚本执行。
返回值:
{ "stdout": "标准输出内容", "stderr": "错误输出内容"}
九、run_command
在沙箱环境中执行 Shell 命令。
功能:
·在安全的沙箱环境中执行任意系统命令。
·支持复杂的命令行操作和脚本。
·返回命令执行的输出和错误信息。
参数:
command(必需):要执行的命令字符串。
返回值:
{ "stdout": "命令标准输出", "stderr": "命令错误输出"}
十、write_file
向沙箱环境写入文件。
功能:
·在沙箱文件系统中创建或覆盖文件。
·支持任意文本内容写入。
·自动创建必要的目录结构。
参数:
·file_path(必需):文件路径。
·content(必需):文件内容。
返回值:
无返回值。
十一、read_file
从沙箱环境读取文件。
功能:
·读取沙箱文件系统中的文件内容。
·支持文这篇件的完整内容读取。
·返回文件的原始内容。
参数:
file_path(必需):要读取的文件路径。
返回值:
文件的文本内容。