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 開發支持。