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 交互，從而更高效地協助您進行代碼開發。