C# Runner 开源项目概述

C# Runner 是为大模型 MCP Code Interpreter 设计的开源工具，旨在支持动态执行 C# 代码片段，提供沙箱环境、依赖管理和安全隔离功能。该项目适用于需要即时编译和运行 C# 代码的场景，如教育、自动化测试或 AI 辅助编程。

核心功能与特性

动态代码执行
支持通过 API 或命令行直接输入 C# 代码并获取执行结果，无需预先编译成程序集。

依赖管理
自动解析代码中的 NuGet 包引用，支持通过配置或代码指定版本，例如：

#r "nuget: Newtonsoft.Json, 13.0.1"  

安全沙箱
限制代码访问权限，防止文件系统、网络等敏感操作，默认启用反射限制和内存管控。

快速入门示例

安装与运行
通过 .NET CLI 安装工具包：

dotnet tool install -g csrunner  

执行代码片段
直接运行代码文件或字符串：

csrunner run --code "Console.WriteLine(DateTime.Now);"  

集成到 MCP Code Interpreter

API 调用方式
提供 RESTful 接口接收代码并返回结构化结果（JSON），响应示例：

{  
  "output": "2023-11-02 14:30:00",  
  "errors": null,  
  "executionTimeMs": 120  
}  

错误处理
捕获编译时和运行时异常，返回详细堆栈信息，便于调试。

高级配置选项

自定义沙箱策略
通过配置文件调整权限，例如允许有限的文件读写：

{  
  "Sandbox": {  
    "FileAccess": "ReadOnly",  
    "MaxMemoryMB": 512  
  }  
}  

性能调优
预加载常用程序集（如 System.Linq）以减少冷启动延迟，支持并发请求隔离。

开源与贡献指南

项目托管于 GitHub，采用 MIT 许可证，欢迎提交 PR 或 Issue。主要开发方向包括：

• 优化大规模代码执行的稳定性
• 扩展第三方库的自动兼容性检测
• 增强沙箱逃逸防护机制

项目地址：https://github.com/mcp-interpreter/csrunner（注：此为示例链接，需替换为真实地址）