关键词

Lisp编程符号编程AI助手代码执行HTTP集成

使用说明

项目简介

Lisply MCP 适配器（Lisply-MCP）是一个基于 Model Context Protocol (MCP) 的软件适配器，旨在弥合大型语言模型 (LLM) 与 Lisp 编程环境之间的鸿沟。它允许 MCP 客户端（如 Claude Desktop）与 Lisp 后端服务器进行交互，从而实现 AI 辅助的符号编程。该适配器默认使用 Gendl (Common Lisp 的超集) 作为后端，并支持通过 Docker 容器进行部署。

主要功能点

  • Lisp 代码执行： 允许 LLM 通过 'lisp_eval' 工具在 Lisp 后端执行代码。支持 HTTP 和 Stdio 两种通信模式，Stdio 模式提供更底层的 REPL 体验，便于调试。
  • HTTP 请求： 通过 'http_request' 工具，LLM 可以向 Lisp 后端服务器的任意 HTTP 端点发送请求，实现与后端应用的集成。
  • 后端服务管理： 能够自动启动和管理 Lisply 后端 Docker 容器（默认 Gendl），简化部署流程。
  • 灵活配置： 支持通过命令行参数和环境变量配置 Lisply 后端的连接信息、Docker 镜像、端口映射、日志等。
  • 安全特性： 推荐在 Docker 容器中运行 Lisp 后端，并提供资源限制和卷挂载等安全建议。

安装步骤

  1. 安装 Node.js 和 Docker: 确保已安装 Node.js 18+ 和 Docker (20+ 推荐)。Windows 用户可以在 Windows 或 WSL 中安装。Docker 需要在 Node.js 运行的同一环境中安装。
  2. 克隆仓库: 使用 git 克隆 'lisply-mcp' 仓库到本地，例如： 
    git clone https://github.com/gornskew/lisply-mcp.git
  3. 安装依赖 (可选): 进入 'lisply-mcp/scripts' 目录，运行 'npm install' 安装依赖。如果缺少依赖，wrapper 脚本也会尝试自动安装。

服务器配置

要将 Lisply MCP 适配器配置为 MCP 服务器，您需要在 MCP 客户端（如 Claude Desktop）的配置文件中添加服务器配置信息。以下是一个 'claude_desktop_config.json' 的配置示例，请根据您的实际仓库路径进行修改：

{
  "mcpServers": {
    "lisply-gendl": {  // 服务器名称，可以自定义
      "command": "node",
      "args": [
        "/path/to/cloned/lisply-mcp/scripts/mcp-wrapper.js" // 指向 mcp-wrapper.js 脚本的路径
      ]
    }
  }
}
  • '"lisply-gendl"': 服务器名称，在 MCP 客户端中用于标识和引用此服务器。您可以自定义名称，确保唯一性。
  • '"command": "node"': 指定启动 MCP 服务器的命令为 'node'，用于执行 JavaScript 脚本。
  • '"args"': 一个字符串数组，包含传递给 'node' 命令的参数。
    • '"/path/to/cloned/lisply-mcp/scripts/mcp-wrapper.js"': 请将 '/path/to/cloned/lisply-mcp' 替换为您克隆仓库的实际本地路径。 这是 'mcp-wrapper.js' 脚本的绝对路径，它是 Lisply MCP 适配器的入口点。

基本使用方法

配置完成后，重启 MCP 客户端。客户端将能够通过 MCP 协议与 Lisply MCP 适配器建立连接，并调用其提供的工具，例如：

  • 使用 'lisp_eval' 工具执行 Lisp 代码。
  • 使用 'ping_lisp' 工具检查 Lisp 后端是否运行。
  • 使用 'http_request' 工具向 Lisp 后端发送 HTTP 请求。

具体工具的使用方法和参数，请参考仓库 README.md 文档中 "3. Available Tools for AI Agents" 章节的说明。

信息

分类

开发者工具

访问项目