Make Copilot An Interactive Programmer

🚀 让 CoPilot 爱上你的 REPL

Calva MCP Server 实现了 模型上下文协议 (MCP)，搭建起 AI 助手与 REPL 之间的桥梁。当 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"
            ]
        }
    }
}

💻 使用示例

基础用法

本项目的使用主要是按照上述快速开始的步骤进行操作，让 AI 助手与 REPL 建立连接并交互。以下是配置 CoPilot 的代码示例，用于让 AI 与 Calva MCP Server 进行通信：

{
    "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 (进行中) 状态，当前版本支持基本功能，更多高级特性正在开发中。

🤝 如何贡献

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

📄 许可证

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

💗 赞助

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

赞助链接

GitHub Sponsors

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