Merge pull request #12111 from logseq/feat/mcp-server

Feat: Add MCP server

Author: logseq-cldwalker

.clj-kondo/config.edn

@@ -164,11 +164,14 @@
              frontend.worker.state worker-state
              frontend.worker.util worker-util
              lambdaisland.glogi log
+             logseq.api.db-based db-based-api
              logseq.cli.common.graph cli-common-graph
-             logseq.cli.text-util cli-text-util
              logseq.cli.common.export.common cli-export-common
              logseq.cli.common.export.text cli-export-text
              logseq.cli.common.file common-file
+             logseq.cli.common.mcp.server cli-common-mcp-server
+             logseq.cli.common.mcp.tools cli-common-mcp-tools
+             logseq.cli.text-util cli-text-util
              logseq.common.config common-config
              logseq.common.date-time-util date-time-util
              logseq.common.graph common-graph
@@ -219,6 +222,7 @@
              logseq.outliner.op outliner-op
              logseq.outliner.page outliner-page
              logseq.outliner.pipeline outliner-pipeline
+             logseq.outliner.tree otree
              logseq.outliner.validate outliner-validate
              logseq.shui.popup.core shui-popup
              logseq.shui.ui shui

deps/cli/.carve/ignore

@@ -6,3 +6,4 @@ logseq.cli.commands.query/query
 logseq.cli.commands.search/search
 logseq.cli.commands.export/export
 logseq.cli.commands.append/append
+logseq.cli.commands.mcp-server/start

deps/cli/.clj-kondo/config.edn

@@ -12,6 +12,8 @@
              clojure.string string
              datascript.core d
              logseq.cli.commands.graph cli-graph
+             logseq.cli.common.mcp.server cli-common-mcp-server
+             logseq.cli.common.mcp.tools cli-common-mcp-tools
              logseq.cli.common.graph cli-common-graph
              logseq.cli.common.export.text cli-export-text
              logseq.cli.common.export.common cli-export-common

deps/cli/README.md

@@ -125,6 +125,13 @@ Exported 16 properties, 16 classes and 36 pages
 # Append text to current page
 $ logseq append add this text -a my-token
 Success!
+
+# Start mcp-server against a local desktop graph
+$ logseq mcp-server -g yep
+MCP Streamable HTTP Server started on 127.0.0.1:12315
+# Start mcp-server against a local graph file
+$ logseq mcp-server -g ~/Downloads/logseq_db_yep_1751032977.sqlite
+MCP Streamable HTTP Server started on 127.0.0.1:12315
 ```
 
 ## API

deps/cli/bb.edn

@@ -40,5 +40,5 @@
 
  :tasks/config
  {:large-vars
-  {:max-lines-count 45
+  {:max-lines-count 50
    :metadata-exceptions #{:large-vars/cleanup-todo}}}}

deps/cli/package.json

@@ -11,10 +11,13 @@
   "license": "MIT",
   "dependencies": {
     "@logseq/nbb-logseq": "github:logseq/nbb-logseq#feat-db-v29",
+    "@modelcontextprotocol/sdk": "^1.17.5",
     "better-sqlite3": "~11.10.0",
+    "fastify": "5.3.2",
     "fs-extra": "^11.3.0",
     "jszip": "3.8.0",
-    "mldoc": "^1.5.9"
+    "mldoc": "^1.5.9",
+    "zod": "^4.1.5"
   },
   "repository": {
     "type": "git",

deps/cli/src/logseq/cli.cljs

@@ -99,6 +99,10 @@
     :fn (lazy-load-fn 'logseq.cli.commands.append/append)
     :args->opts [:args] :require [:args] :coerce {:args []}
     :spec cli-spec/append}
+   {:cmds ["mcp-server"] :desc "Run a MCP server"
+    :description "Run a MCP server against a local graph if --graph is given or against the current in-app graph. By default the MCP server runs as a HTTP Streamable server. Use --stdio to run it as a stdio server."
+    :fn (lazy-load-fn 'logseq.cli.commands.mcp-server/start)
+    :spec cli-spec/mcp-server}
    {:cmds ["help"] :fn help-command :desc "Print a command's help"
     :args->opts [:command] :require [:command]}
    {:cmds []

deps/cli/src/logseq/cli/commands/export.cljs

@@ -74,7 +74,7 @@
         (println "Exported" (count exported-files) "pages to" file-name)))))
 
 (defn export [{{:keys [graph] :as opts} :opts}]
-  (if (fs/existsSync (cli-util/get-graph-dir graph))
+  (if (fs/existsSync (cli-util/get-graph-path graph))
     (let [conn (apply sqlite-cli/open-db! (cli-util/->open-db-args graph))]
       (export-repo-as-markdown! (str common-config/db-version-prefix graph) @conn opts))
     (cli-util/error "Graph" (pr-str graph) "does not exist")))

deps/cli/src/logseq/cli/commands/export_edn.cljs

@@ -8,7 +8,7 @@
             [logseq.cli.util :as cli-util]))
 
 (defn export [{{:keys [graph] :as options} :opts}]
-  (if (fs/existsSync (cli-util/get-graph-dir graph))
+  (if (fs/existsSync (cli-util/get-graph-path graph))
     (let [conn (apply sqlite-cli/open-db! (cli-util/->open-db-args graph))
           export-map (sqlite-export/build-export @conn
                                                  (cond-> {:export-type (:export-type options)}

deps/cli/src/logseq/cli/commands/graph.cljs

@@ -19,7 +19,7 @@
 (defn show-graph
   [{{:keys [graphs]} :opts}]
   (doseq [graph graphs]
-    (let [graph-dir (cli-util/get-graph-dir graph)]
+    (let [graph-dir (cli-util/get-graph-path graph)]
       (if (fs/existsSync graph-dir)
         (let [conn (apply sqlite-cli/open-db! (cli-util/->open-db-args graph))
               kv-value #(:kv/value (d/entity @conn %))]