Logseq MCP服务器

yalms（另一个Logseq MCP服务器）

yalms 是一个模型上下文协议（MCP）服务器，它提供了一个与Logseq图交互的结构化接口。它允许AI模型在Logseq中读取、创建、更新和管理页面和块，支持一般大纲图使用和本体数据建模。

特性

• 模型上下文协议（MCP）：实施MCP标准，与AI工具和IDE无缝集成。
• 两种操作模式:
  • 一般模式：用于管理页面和块的标准大纲视图行为。
  • 本体论模式：通过命名空间支持和snake_case属性规范化对结构化数据进行优化。
• 智能链接管理：自动处理链接的页面创建，并将命名空间链接转换为UUID引用，以保持图的完整性。
• 综合API：支持搜索、批处理操作、标签管理和复杂的块树操作。

安装

先决条件

• 转到1.21或更高版本。
• 一个正在运行的Logseq实例 HTTP API 启用。

从源代码构建

git clone https://github.com/clstb/yalms.git
cd yalms
go build -o yalms ./cmd/yalms

用法

使用CLI启动服务器：

./yalms [flags]

配置标志

可用工具

服务器根据活动模式公开了几个MCP工具：

图形工具

• read_graph_info：获取当前Logseq图的元数据。
• query：对Logseq数据库执行高级数据日志查询。
• list_namespaces：列出图中所有现有的命名空间。
• get_daily_journal：检索今天期刊的页面详细信息。

页面/实体工具

• read_page （一般）/ read_entity （本体论）：检索结构化数据和属性。
• create_entity：创建一个新的命名空间实体（Ontological）或页面（General）。
• create_pages （常规）：在一次调用中创建多个页面。
• update_page （一般）/ update_entity （本体论）：修改属性。
• delete_page （一般）/ delete_entity （本体论）：永久删除页面/实体。
• delete_pages （常规）：永久删除多个页面。
• rename_page：按UUID重命名现有页面/实体。

命名空间工具

• read_namespace：列出特定命名空间内的所有实体或页面。
• create_namespace （General）：创建新的命名空间/类别级别。

阻止/输入工具

• read_block （一般）/ read_entry （本体论）：检索特定块/条目的详细信息。
• create_block （一般）/ create_entry （本体论）：在父项下插入单个块/条目。
• create_block_tree （一般）/ create_entry_tree （本体论）：插入结构化层次结构。
• append_block （一般）/ append_entry_to_entity （本体论）：添加到页面/实体的末尾。
• update_block （一般）/ update_entry （本体论）：修改内容或属性。
• remove_block （一般）/ remove_entry （本体论）：删除块/条目。
• remove_blocks （通用）：删除多个块。

标记/属性工具

• add_tag：添加a #tag 到块/条目或页面/实体（类/通用）。
• remove_tag：删除发现标记（类/通用）。
• add_property：添加或更新特定元数据属性（属性/关系）。
• remove_property：删除特定的元数据属性（属性/关系）。

本体映射

yalms 支持映射到Logseq原生结构的本体数据模型：

发展

运行测试

要运行标准单元测试，请执行以下操作：

go test ./...

要运行集成测试（需要一个正在运行的Logseq实例）：

LOGSEQ_API_TOKEN=your_token go test ./pkg/logseq -v

项目结构

• cmd/yalms：CLI入口点。
• internal/server：MCP服务器实现和请求处理程序。
• pkg/logseq：Logseq API客户端和数据模型。

许可证

MIT许可证