Purescript MCP Tools

🚀 PureScript MCP 服务器

本服务器基于模型上下文协议（MCP）构建，为 Claude 等 AI 助手提供 PureScript 开发工具支持，助力 AI 更高效地开展 PureScript 开发工作。

🚀 快速开始

📦 安装指南

1. 下载并设置

# 克隆此仓库
git clone <repository-url>
cd purescript-mcp-server

# 安装依赖
npm install

# 测试是否正常工作
node index.js
# 按 Ctrl+C 停止

2. 配置你的 MCP 客户端

对于 Claude 桌面版

1. 找到你的 Claude 配置文件：
   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
2. 添加以下服务器配置：

{
  "mcpServers": {
    "purescript-tools": {
      "command": "node",
      "args": ["/FULL/PATH/TO/purescript-mcp-server/index.js"]
    }
  }
}

3. 重要提示：将 /FULL/PATH/TO/ 替换为你克隆此仓库的实际绝对路径。
4. 重启 Claude 桌面版。

对于其他 MCP 客户端

将其配置为标准输入输出（stdio）MCP 服务器：

• 命令：node
• 参数：["/full/path/to/index.js"]
• 协议：stdio

3. 验证安装

在你的 MCP 客户端中，尝试运行：

get_server_status

你应该会看到一个响应，表明服务器正在运行。

💻 使用示例

基础用法

1. 检查状态：get_server_status
2. 进行简单分析：直接使用 getModuleName、getImports 等命令。

高级用法

若要使用高级功能，请按以下步骤操作：

• 使用 start_purs_ide_server 并指定你的项目路径。
• 使用 pursIdeLoad 加载模块。
• 使用 pursIdeType、pursIdeUsages 等命令。

✨ 主要特性

此 MCP 服务器使 AI 助手具备以下能力：

• 分析 PureScript 代码：无需进行复杂的 IDE 设置。
• 启动/管理 PureScript IDE 服务器：以使用高级功能。
• 查找类型和代码使用情况。
• 生成依赖图。
• 解析代码结构（模块、导入、函数）。

📚 详细文档

要求

• Node.js（任何较新的版本）
• 若使用 IDE 功能，需要 PureScript 编译器 (purs)
• 带有编译输出的 PureScript 项目

故障排除

• 服务器无法启动：检查 Node.js 是否已安装，并确保你运行了 npm install。
• 工具无法正常工作：首先运行 get_server_status，查看可用的功能。
• 路径错误：确保在 MCP 配置中使用了完整的绝对路径。
• 多个服务器：一次只运行一个 PureScript IDE 服务器，以避免冲突。

支持

本服务器通过标准化的 MCP 协议，为 AI 工具提供全面的 PureScript 开发支持。