项目简介

Calva MCP Server 是一个 Model Context Protocol (MCP) 服务器，作为 VS Code 扩展与 Calva（Clojure/ClojureScript 扩展）集成。它允许支持 MCP 的 AI 助手（如 GitHub Copilot）直接访问并与你的 Clojure/ClojureScript REPL 交互，从而实现更智能、基于实际运行环境的代码理解和生成。

主要功能点

• 让 AI 助手在你的 Clojure REPL 中执行代码，获取真实的运行结果。
• 使 AI 助手能够查看实际的运行时数据结构和函数行为。
• 支持 AI 助手进行实时代码评估和调试辅助，减少“猜”代码的情况。
• 与 Calva 和现有 Clojure 项目无缝集成，成为 REPL 驱动工作流的一部分。

安装步骤

1. 确保你已安装 VS Code。
2. 在 VS Code 扩展商店中搜索并安装 Calva 扩展。
3. 在 VS Code 扩展商店中搜索并安装 Calva MCP Server 扩展。
4. 确保你的项目已设置好 Clojure 开发环境（如安装 Clojure、Babashka 等）并能正常启动 REPL。

服务器配置

你需要通过你的 MCP 客户端（例如 GitHub Copilot）来配置与 Calva MCP Server 的连接。通常，这涉及到编辑项目根目录下的 '.vscode/mcp.json' 文件。你需要添加一个新的服务器配置项，指定服务器的名称（例如 '"calva"'）、连接类型为 'stdio'。关键在于配置启动服务器所需的 'command' 和 'args'。

• 'command': 应指向你的系统中的 Node.js 可执行文件路径。
• 'args': 应包含两部分。第一部分是 Calva MCP Server 扩展安装目录下的启动脚本路径；第二部分是你项目工作空间内用于通信的端口文件路径（例如 '${workspaceFolder}/.calva/mcp-server/port'）。

请参考你的 MCP 客户端文档或 Calva MCP Server 的 README 文件，获取用于 '.vscode/mcp.json' 的完整、准确的配置示例。完成配置后，你的 MCP 客户端就能知道如何启动并连接到 Calva MCP Server。

基本使用方法

1. 在 VS Code 中，使用 Calva 连接到你的 Clojure/ClojureScript 项目的 REPL。
2. 打开 VS Code 命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)，运行命令 Calva MCP Server: Start the socket server 启动 MCP 内部的 socket 服务器。
3. 打开 '.vscode/mcp.json' 文件，使用 MCP 客户端（如 GitHub Copilot）提供的 UI 启动配置好的 '"calva"' 服务器（这将启动 stdio wrapper）。
4. 现在你可以使用你的 AI 助手，它将能够通过 Calva MCP Server 访问并执行 REPL 中的代码。
5. 完成工作后，建议首先使用命令 Calva MCP Server: Stop the socket server 来关闭 MCP 服务器，然后再关闭相关的编辑器或 REPL 连接。

安全提示: 请务必注意，通过此服务器，AI 助手可以执行你在连接的 REPL 环境中拥有的任何操作。在使用前请充分了解其潜在的安全影响。