Purescript MCP Tools

🚀 PureScript MCP Server

このサーバーは、ClaudeなどのAIアシスタントにPureScript開発ツールを提供するModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

📦 インストール

1. ダウンロードとセットアップ

# このリポジトリをクローンします
git clone <repository-url>
cd purescript-mcp-server

# 依存関係をインストールします
npm install

# 動作をテストします
node index.js
# Ctrl+Cを押して停止します

2. MCPクライアントの設定

Claude Desktopの場合

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 Desktopを再起動します。

その他のMCPクライアントの場合

stdio MCPサーバーとして設定します:

• コマンド: node
• 引数: ["/full/path/to/index.js"]
• プロトコル: stdio

3. インストールの確認

MCPクライアントで、以下を実行してみてください:

get_server_status

サーバーが実行中であることを示す応答が表示されるはずです。

💻 使用例

基本的な使用法

このMCPサーバーを使用する基本的な流れは以下の通りです。

# サーバーの状態を確認します
get_server_status

高度な使用法

# シンプルな解析を行います
getModuleName
getImports

# 高度な機能を使用する場合
# プロジェクトパスを指定してpurs IDEサーバーを起動します
start_purs_ide_server /your/project/path
# モジュールをロードします
pursIdeLoad
# 型を調べたり、コードの使用箇所を検索します
pursIdeType
pursIdeUsages

✨ 主な機能

このMCPサーバーは、AIアシスタントに以下の機能を提供します:

• PureScriptコードの解析: 大規模なIDEのセットアップなしでPureScriptコードを解析できます。
• PureScript IDEサーバーの起動と管理: 高度な機能のためにPureScript IDEサーバーを起動および管理できます。
• 型の検索とコードの使用箇所の検索: コード内の型を検索し、コードの使用箇所を見つけることができます。
• 依存関係グラフの生成: コードの依存関係グラフを生成できます。
• コード構造の解析: モジュール、インポート、関数などのコード構造を解析できます。

🔧 技術詳細

必要条件

• Node.js (最近のバージョンであればどれでも可)
• PureScriptコンパイラ (purs) (IDE機能を使用する場合)
• コンパイル済みの出力を持つPureScriptプロジェクト

📄 トラブルシューティング

⚠️ 重要提示

• サーバーが起動しない場合: Node.jsがインストールされていること、およびnpm installを実行したことを確認してください。
• ツールが機能しない場合: まずget_server_statusを実行して、利用可能な機能を確認してください。
• パスエラーが発生する場合: MCP設定で完全な絶対パスを使用していることを確認してください。
• 複数のサーバーを実行する場合: 競合を避けるため、一度に1つのPureScript IDEサーバーのみを実行してください。

📄 サポート

このサーバーは、標準化されたMCPプロトコルを通じて、AIツールに包括的なPureScript開発支援を提供します。