MCP日志序列服务器

Name: MCP日志序列服务器
Author: ergut

作者：ergut146 星标更新：2025-08-21

项目介绍

<div align="center"> <img src="assets/images/logo.png" alt="MCP LogSeq" width="200" height="200"> <h1>用于LogSeq的MCP服务器</h1> <p>MCP服务器通过LogSeq的API与其进行交互。它使Claude能够读取、创建和管理LogSeq页面，通过一系列全面的工具。</p> </div>

✨ 您可以做什么

将您的LogSeq知识库转变为一个由AI驱动的工作空间！这个MCP服务器让Claude能够无缝地与您的LogSeq图谱互动。

🎯 实际应用示例

📊 智能知识管理

“分析我过去一个月的所有项目笔记，并创建状态总结”
“查找提到‘机器学习’的页面并创建学习路线图”
“搜索所有页面中的未完成任务”

📝 自动内容创作

“创建一个名为‘今日站会’的新页面，包含我的会议笔记”
“在我的现有项目时间线页面中添加今天的进度更新”
“从最近的笔记中创建每周回顾页面”

🔍 智能研究与分析

“比较我对React和Vue的笔记，并突出关键差异”
“查找所有关于‘客户反馈’的引用并总结主题”
“创建一个知识地图，连接跨页面的相关主题”

🤝 会议及文档工作流程

“阅读我的会议笔记，并为每个行动项创建单独的任务页面”
“获取本周的日记条目并创建摘要页面”
“搜索‘第四季度规划’并将所有相关内容组织到一个新的概览页面中”

💡 主要优势

零上下文切换：Claude直接与您的LogSeq数据工作
保持您的工作流程：无需手动导出或复制内容
智能组织：由AI驱动的页面创建、链接和搜索
提高生产力：自动化重复的知识工作

🚀 快速开始

第一步：启用LogSeq API

设置 → 功能 → 勾选“启用HTTP API服务器”
在LogSeq中点击API按钮(🔌) → “启动服务器”
生成API令牌：API面板 → “授权令牌” → 创建新令牌

第二步：添加到Claude（无需安装！）

Claude Code

claude mcp add mcp-logseq \
  --env LOGSEQ_API_TOKEN=your_token_here \
  --env LOGSEQ_API_URL=http://localhost:12315 \
  -- uv run --with mcp-logseq mcp-logseq

Claude Desktop

在您的配置文件中添加（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "mcp-logseq": {
      "command": "uv",
      "args": ["run", "--with", "mcp-logseq", "mcp-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "your_token_here",
        "LOGSEQ_API_URL": "http://localhost:12315"
      }
    }
  }
}

第三步：开始使用！

“请帮我整理我的LogSeq笔记。显示我有哪些页面。”

🛠️ 可用工具

该服务器提供6个全面的工具：

工具	目的	示例用途
`list_pages`	浏览您的图谱	“显示我所有的页面”
`get_page_content`	阅读页面内容	“获取我的项目笔记”
`create_page`	添加新页面	“创建一个会议笔记页面”
`update_page`	修改现有页面	“更新我的任务列表”
`delete_page`	删除页面	“删除旧草稿页面”
`search`	在图谱中查找内容	“搜索‘生产力技巧’”

⚙️ 先决条件

LogSeq 设置

安装并运行LogSeq
启用HTTP API服务器（设置 → 功能）
启动API服务器（🔌按钮 → “启动服务器”）
生成API令牌（API面板 → 授权令牌）

系统需求

uv Python包管理器
兼容MCP的客户端（Claude Code，Claude Desktop等）

🔧 配置

环境变量

LOGSEQ_API_TOKEN（必需）：您的LogSeq API令牌
LOGSEQ_API_URL（可选）：服务器URL（默认：http://localhost:12315）

替代设置方法

使用.env文件

# .env
LOGSEQ_API_TOKEN=your_token_here
LOGSEQ_API_URL=http://localhost:12315

系统环境变量

export LOGSEQ_API_TOKEN=your_token_here
export LOGSEQ_API_URL=http://localhost:12315

🔍 验证与测试

测试LogSeq连接

uv run --with mcp-logseq python -c "
from mcp_logseq.logseq import LogSeq
api = LogSeq(api_key='your_token')
print(f'已连接！找到 {len(api.list_pages())} 页')
"

验证MCP注册

claude mcp list  # 应显示mcp-logseq

使用MCP Inspector调试

npx @modelcontextprotocol/inspector uv run --with mcp-logseq mcp-logseq

🐛 故障排除

常见问题

“需要LOGSEQ_API_TOKEN环境变量”

✅ 在设置 → 功能中启用HTTP API
✅ 在LogSeq中点击🔌按钮 → “启动服务器”
✅ 在API面板 → 授权令牌中生成令牌
✅ 在您的配置中验证令牌

“spawn uv ENOENT”（Claude Desktop）

Claude Desktop找不到uv。使用完整路径：

which uv  # 查找您的uv位置

在配置中更新完整路径：

{
  "mcpServers": {
    "mcp-logseq": {
      "command": "/Users/username/.local/bin/uv",
      "args": ["run", "--with", "mcp-logseq", "mcp-logseq"],
      "env": { "LOGSEQ_API_TOKEN": "your_token_here" }
    }
  }
}

常见uv位置：

Curl安装：~/.local/bin/uv
Homebrew：/opt/homebrew/bin/uv
Pip安装：使用which uv检查

连接问题

✅ 确认LogSeq正在运行
✅ 确认API服务器已启动（而不仅仅是启用）
✅ 检查端口12315是否可访问
✅ 使用上述验证命令进行测试

👩‍💻 开发

对于本地开发、测试和贡献，请参阅**DEVELOPMENT.md**。

<div align="center"> <p><strong>准备好用AI增强您的LogSeq工作流程了吗？</strong></p> <p>⭐ 如果您觉得这很有帮助，请给这个仓库加星！</p> </div>