作者 ergut · ergut/mcp-logseq
让你的 Logseq 知识图谱支持 AI 查询 — 读取页面、创建块、按属性搜索、运行 DSL 查询 — 通过 Logseq 的本地 HTTP API。
mcp-logseq（由 ergut 开发）将 MCP 客户端连接到 Logseq 的本地 HTTP API。16 个核心工具覆盖页面、块、命名空间、反向链接和 DSL 查询。可选的向量搜索为整个知识图谱添加语义检索能力。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"logseq": {
"command": "uvx",
"args": [
"mcp-logseq"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"logseq": {
"command": "uvx",
"args": [
"mcp-logseq"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"logseq": {
"command": "uvx",
"args": [
"mcp-logseq"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"logseq": {
"command": "uvx",
"args": [
"mcp-logseq"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "logseq",
"command": "uvx",
"args": [
"mcp-logseq"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"logseq": {
"command": {
"path": "uvx",
"args": [
"mcp-logseq"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add logseq -- uvx mcp-logseq一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 周五反思；你想要本周日记页面的总结。
结果： 用最少的输入完成一个周度反思闭环。
何时使用： 你用 status:: active 标记项目页面，想要一个列表。
结果： 清晰列出活跃项目及其下一步行动的扫描。
何时使用： 关键词搜索找不到你知道自己写过的笔记。
结果： 按含义而非精确词汇查找笔记。
何时使用： 你在 Logseq 中记录会议，想要分离出行动项。
结果： 从笔记中提取行动项到可跟踪的列表。
MARM 中的短期回忆；Logseq 中的持久笔记
将精选的 Logseq 页面导出为 Markdown 文件
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| list_pages | (none) | 图谱概览 | free (local API) |
| get_page_content | name: str | 读取页面 | free |
| create_page | name, content, properties? | 新建页面 | free (write) |
| update_page | name, content, mode: append|replace | 编辑现有页面 | free (write) |
| delete_page | name: str | 破坏性操作 — 确认 | free |
| search | query: str | 全文搜索 | free |
| query | dsl: str | Logseq DSL 查询 | free |
| find_pages_by_property | key: str, value?: str | 按属性过滤 | free |
| get_page_backlinks | name: str | 谁链接到这个笔记 | free |
| insert_nested_block | parent_uuid, content, position: child|sibling | 添加结构化内容 | free (write) |
| vector_search | query: str | 语义回忆 | free (local embeddings) |
不要在没有防火墙的情况下将 Logseq 的 HTTP API 暴露到局域网Connection refused on localhost:12315通过 Logseq 中的插件图标启动 HTTP API。默认关闭。
curl http://localhost:12315401 on API callsToken 丢失或不匹配。在 Logseq 授权令牌中重新生成。
Check token in Logseq settingsvector_search empty先运行 sync_vector_db；它不会自动同步。
vector_db_status| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| Obsidian MCP (community) | 你改用 Obsidian | 不同的图谱语义 |
| Notion MCP | 你在使用 Notion | 付费 SaaS；不同的图谱模型 |
| filesystem MCP on the Logseq dir | 你只需要原始文件访问 | 没有块级操作，没有 DSL 查询 |