使用说明

项目简介

Calva MCP Server 是一个 Model Context Protocol (MCP) 服务器，旨在桥接 AI 助手（如 GitHub Copilot）和 Clojure/ClojureScript 开发环境。通过这个服务器，AI 助手可以访问和利用 Calva REPL 的强大功能，实现代码的实时评估、数据探索和更智能的代码建议，将 AI 从静态代码生成器转变为交互式编程伙伴。

主要功能点

REPL 代码执行: 允许 AI 助手在真实的 Clojure/ClojureScript REPL 环境中执行代码，获取实际运行结果，而非仅仅猜测代码行为。
动态数据探索: AI 助手可以查看 REPL 中的真实数据结构，从而更准确地理解代码上下文和数据形态。
REPL 调试辅助: 通过访问 REPL 运行时信息，AI 助手可以辅助开发者进行代码调试。
与 Calva 和 VS Code 集成: 无缝集成到 Calva 和 VS Code 环境中，为 Clojure/ClojureScript 开发者提供便捷的 AI 辅助编程体验。

安装步骤

安装 VS Code 和 Calva 扩展: 确保已安装 VS Code 和 Calva (Clojure/ClojureScript 的 VS Code 扩展)。
安装 Calva MCP Server 扩展: 在 VS Code 扩展商店中搜索并安装 "Calva MCP Server"。
启动 Calva MCP Socket Server: 在 VS Code 中，连接到您的 Clojure/ClojureScript 项目，并执行命令 'Calva MCP Server: Start the socket server'。

配置 MCP 服务器: 在您的项目根目录下（或 '.vscode' 目录下）创建或编辑 '.vscode/mcp.json' 文件，并添加以下服务器配置信息：

{
  "servers": {
    "calva": {
      "type": "stdio",
      "command": "node",
      "args": [
        "${extensionInstallFolder:betterthantomorrow.calva-mcp-server}/dist/calva-mcp-server.js",
        "${workspaceFolder}"
      ]
    }
  }
}

'"calva"': 服务器名称，可以自定义。
'"type": "stdio"': 指定 MCP 服务器的传输协议为 Stdio。
'"command": "node"': 启动 MCP 服务器的命令，这里使用 Node.js 解释器。
'"args"': 启动命令的参数列表：
- '"${extensionInstallFolder:betterthantomorrow.calva-mcp-server}/dist/calva-mcp-server.js"': Calva MCP Server 扩展安装目录下的 'calva-mcp-server.js' 脚本路径，负责启动 MCP 服务器。
- '"${workspaceFolder}"': 当前 VS Code 工作区目录，作为参数传递给服务器。

启动 MCP 服务器: 在 '.vscode/mcp.json' 文件中，找到 '"calva"' 服务器配置，点击 "Start" 按钮启动 MCP 服务器。

基本使用方法

确保已连接 Calva 到您的 Clojure/ClojureScript 项目，并且 Calva REPL 正常工作。
启动 Calva MCP Socket Server (命令 'Calva MCP Server: Start the socket server')。
启动 '.vscode/mcp.json' 中配置的 "calva" 服务器。
您的 AI 助手 (如 GitHub Copilot) 现在应该能够通过 Calva MCP Server 与您的 Clojure REPL 交互，例如，它可以请求执行 Clojure 代码以获取更准确的代码建议和上下文信息。

使用完毕后

执行命令 'Calva MCP Server: Stop the socket server' 停止 Calva MCP Socket Server。

注意事项

由于 AI 助手可以通过 REPL 执行代码，请务必谨慎使用，确保您了解潜在的安全风险。

关键词

使用说明

信息