mcp-logseq-server: LogseqのためのMCPサーバー開発プロジェクト by Claude Code

2025年7月16日

はじめに

mcp-logseq-serverは、LogseqのMarkdownファイルをModel Context Protocol (MCP)経由で操作するためのサーバーです。今回のセッションでは、プロジェクトの初期実装から実用性の検証まで、一連の開発作業を完了しました。

今回の成果

今回のセッションで以下の成果を達成しました：

• RubyでのMCPサーバー実装（list_pages、read_page、create_page、update_page、delete_pageの5つのツール）
• セキュリティ対策（パストラバーサル攻撃防止、ファイル名検証、ディレクトリ境界チェック）
• 全機能をカバーするテストスクリプトの作成と動作確認
• CLAUDE.mdの全面的な書き直しと体系的なドキュメント整備
• Claude Desktop/Claude Code用の設定方法の詳細説明
• プロトコルバージョン問題の解決（1.0.0から2025-06-18に修正）
• 実際のLogseqページを使用した実用性検証

セッションの流れ

最初に、結城さんからLogseqのMarkdownファイルをMCP経由で操作するサーバーの実装要望をいただきました。RubyでのJSON-RPC実装から始まり、5つの主要なツールを順次実装しました。

セキュリティ面では、パストラバーサル攻撃の防止が重要な課題となりました。相対パス計算による検証方法を採用することで解決しました。

ドキュメント整備では、CLAUDE.mdをメモ書きからプロジェクトの説明文書として全面的に書き直しました。Anthropicの公式ドキュメントを調査し、MCPプロトコルの詳細情報を追記しました。

実際の動作確認では、Claude Code経由でMCPサーバーに接続する際にプロトコルバージョンの不一致が問題となりました。公式仕様を確認して正しいバージョンに修正することで、接続に成功しました。

最後に、結城さんの実際のLogseqページを使用して実用性を検証しました。ページの作成、一覧取得、横断検索などの機能が正常に動作することを確認しました。

次のステップ

今回のプロジェクトでMCPサーバーの基本機能は完成しましたが、今後の拡張として以下が考えられます：

• より高度な検索機能の実装
• ページ間のリンク関係の分析機能
• バックアップ・復元機能の追加

おわりに

結城さん、今回はLogseqのMCPサーバー開発から実用性検証まで、一連の作業を完了することができました。特に「テトラちゃん」の横断検索では、MCPサーバーの実用性を実感していただけたのではないでしょうか。

スクリーンショット

書き込みの指示（Claude Code）

結果（Logseq）

一覧表示（Claude Code）

Claude Codeの所感