Make Copilot An Interactive Programmer

🚀 让 CoPilot 爱上你的 REPL

Calva MCP Server 为 AI 助手与 REPL 搭建了沟通桥梁，借助 模型上下文协议 (MCP)，当 AI 助手需要深入理解代码时，可将代码在您的 REPL 中执行，并获取实际的数据形状和函数行为反馈，极大提升代码开发效率。

🚀 快速开始

1. 把 Calva 连接到您的 Clojure/ClojureScript 项目。
2. 执行命令：Calva MCP Server: 启动套接字服务器。
3. 在 .vscode/mcp.json 文件里，使用 启动 按钮启动 "calva" 服务器。
4. 若希望 AI 拥有完整的 REPL 权限，可在设置中启用。

✨ 主要特性

• REPL 功能：AI 能直接调用 REPL，获取实时数据反馈。
• 项目集成：可与 Clojure/ClojureScript 项目无缝连接。
• 配置灵活：支持多种 AI 客户端的自定义配置。
• 可扩展性：未来会提供更多 Calva 功能。

📦 安装指南

配置 CoPilot

{
    "servers": {
        // 其他服务器配置（如有）
        "calva": {
            "type": "stdio",
            "command": "node",
            "args": [
                "${extensionInstallFolder:betterthantomorrow.calva-mcp-server}/dist/calva-mcp-server.js",
                "${workspaceFolder}/.calva/mcp-server/port"
            ]
        }
    }
}

💻 使用示例

基础用法

{
    "servers": {
        // 其他服务器配置（如有）
        "calva": {
            "type": "stdio",
            "command": "node",
            "args": [
                "${extensionInstallFolder:betterthantomorrow.calva-mcp-server}/dist/calva-mcp-server.js",
                "${workspaceFolder}/.calva/mcp-server/port"
            ]
        }
    }
}

工作原理

1. 您编写代码时，AI 通过 MCP 协议与 Calva 连接。
2. AI 可直接调用 REPL 执行代码片段。
3. 执行结果返回给 AI，助其理解代码的实际行为。
4. 您始终掌控整个过程。

📚 详细文档

系统架构

flowchart TD
    subgraph 交互式程序员["交互式程序员"]
        User([您])
        AIAgent([AI 代理])
        User <--> AIAgent
    end

    subgraph VS Code["VS Code"]

        MCP["Calva MCP Server"]

        subgraph Calva["Calva"]
            REPLClient["REPL 客户端"]
        end

        subgraph Project["Clojure 项目"]

            subgraph 运行中的应用["运行中应用"]
                SourceCode["源代码"]
                REPL["REPL"]
            end
        end
    end

    User --> SourceCode
    User --> Calva
    REPLClient --> REPL
    AIAgent --> SourceCode
    AIAgent --> MCP
    MCP --> Calva

    classed edge 虚线为 ["淡蓝色"，"实线"]

项目现状

WIP (进行中)：当前版本支持基本功能，更多高级特性正在开发中。

🔧 技术细节

Calva MCP Server 实现了 模型上下文协议 (MCP)，该协议为 AI 助手与 REPL 之间的通信提供了标准。通过该协议，AI 助手可以将代码发送到 REPL 中执行，并获取执行结果，从而更好地理解代码的实际行为。

🤝 如何贡献

• 提交问题和建议到 GitHub 仓库。
• 欢迎 fork 代码库并提交 pull request。
• 参与社区讨论，分享使用经验。

📄 许可证

项目采用 MIT 许可证。详细信息请查看 LICENSE 文件。

💗 赞助

如果您觉得这个项目有帮助，请考虑赞助以支持其持续开发。

赞助链接

GitHub Sponsors

通过 Calva MCP Server，您的 AI 助手将能够直接与 REPL 交互，从而更高效地协助您进行代码开发。