mcp-pkm-logseq mcp服务器
MCP服务器，用于使用自定义指令与您的Logseq个人知识管理系统进行交互
组件
资源
logseq://guide-关于如何与此知识库交互的初步说明
工具
get_personal_notes_instructions()-获取有关如何使用个人笔记工具的说明get_personal_notes(topics, from_date, to_date)-从Logseq中检索标记有指定主题的个人笔记get_todo_list(done, from_date, to_date)-从Logseq检索待办事项列表
配置
可以配置以下环境变量：
LOGSEQ_API_KEY：用于使用Logseq进行身份验证的API密钥（默认值：“this-is-my-Logseq-mcp-token”）LOGSEQ_URL：运行Logseq HTTP API的URL（默认值：“http://localhost:12315")
快速启动
安装
克劳德桌面和光标
在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json
Published Servers Configuration
"mcpServers": {
"mcp-pkm-logseq": {
"command": "uvx",
"args": [
"mcp-pkm-logseq"
],
"env": {
"LOGSEQ_API_TOKEN": "your-logseq-api-token",
"LOGSEQ_URL": "http://localhost:12315"
}
}
}克劳德代码
claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq启动Logseq服务器
Logseq的HTTP API是一个在桌面Logseq应用程序中运行的接口。启用后，它将启动一个本地HTTP服务器（默认端口12315），允许对Logseq知识库进行编程访问。API支持查询页面和块、搜索内容，并可能通过身份验证请求修改内容。
要启用Logseq HTTP API服务器，请执行以下操作：
- 打开Logseq并转到设置（右上角）
- 导航到高级
- 启用“开发人员模式”
- 启用“HTTP API服务器”
- 设置API令牌（这应该与
LOGSEQ_API_KEYMCP服务器配置中的值）
有关更多详细说明，请参阅：https://logseq-copilot.eindex.me/doc/setup
创建MCP PKM Logseq页面
在Logseq图中创建一个名为“MCP PKM Logseq”的页面，作为AI助手的指南。添加以下内容：
- 标签系统的描述（例如，哪些标签代表项目、区域、资源）
- 常用标签列表及其涵盖的主题
- 用于组织信息的常见工作流
- 页面和块的命名约定
- 关于您希望如何检索信息的说明
- 用于搜索的有用主题组合示例
- 关于你的个人知识管理方法的任何背景
每当AI认为需要了解用户时，就会显示此页面。
发展
建筑与出版
准备分发包裹：
- 同步依赖关系并更新锁文件：
uv sync- 构建包分发：
uv build这将在 dist/ 目录。
- 发布到PyPI：
uv publish注意：您需要通过环境变量或命令标志设置PyPI凭据：
- 令牌：
--token或UV_PUBLISH_TOKEN - 或用户名/密码：
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.
您可以通过以下方式启动MCP检查器 使用此命令：
npx @modelcontextprotocol/inspector uv --directory /Users/ronie/MCP/mcp-pkm-logseq run mcp-pkm-logseq启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。
将开发服务器配置添加到Claude Desktop
"mcpServers": {
"mcp-pkm-logseq": {
"command": "uv",
"args": [
"--directory",
"/
/mcp-pkm-logseq",
"run",
"mcp-pkm-logseq"
],
"env": {
"LOGSEQ_API_TOKEN": "your-logseq-api-token",
"LOGSEQ_URL": "http://localhost:12315"
}
}
}