Journey Log MCP Server

行程日志MCP服务器

将您的AI编码助手（Claude Desktop、Cursor、VS Code）连接到旅程日志，并自动记录您的开发旅程。

什么是旅程日志？

Journey Log Compass是一个平台，帮助开发人员记录他们的人工智能辅助编码之旅。使用此MCP服务器，您可以：

• 📝 直接从您的AI对话中创建文档
• 💾 保存代码片段和调试会话
• 🔄 用上下文捕捉整个AI对话
• 🏷️ 使用标签和可搜索内容进行组织
• 🚀 从你的开发工作中建立知识库

安装

npm install -g @journey-log/mcp-server

快速开始

1.获取API密钥

1. 登录到…… 行程日志
2. 转到“设置”→ API密钥
3. 创建新的API密钥
4. 复制密钥（您只会看到一次！）

2.配置您的AI工具

Claude Code (Recommended - One Command!)

只需在终端中运行以下命令：

claude mcp add journey-log -s user -e JOURNEY_LOG_API_KEY="your_key_here" -- npx -y @journey-log/mcp-server

Windows用户（非WSL）：

claude mcp add journey-log -s user -e JOURNEY_LOG_API_KEY="your_key_here" -- cmd /c npx -y @journey-log/mcp-server

就是这样！类型 /mcp 在Claude Code中验证它是否已连接。

Claude Desktop

添加到您的Claude Desktop配置中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "journey-log": {
      "command": "npx",
      "args": ["-y", "@journey-log/mcp-server"],
      "env": {
        "JOURNEY_LOG_API_KEY": "jl_your-api-key-here"
      }
    }
  }
}

保存后重新启动Claude Desktop。

Cursor

添加到光标设置中：

{
  "mcp.servers": {
    "journey-log": {
      "command": "npx",
      "args": ["-y", "@journey-log/mcp-server"],
      "env": {
        "JOURNEY_LOG_API_KEY": "jl_your-api-key-here"
      }
    }
  }
}

保存后重新启动Cursor。

可用命令

配置后，您可以在AI对话中使用这些命令：

创建新文档

"Create a new Journey Log document about implementing authentication"

向文档添加内容

"Add this code snippet to my authentication document"

捕捉AI对话

"Save this entire debugging session to my Journey Log"

列出您的文档

"Show me my recent Journey Log documents"

获取特定文档

"Get my document about React hooks"

示例用法

在克劳德代码中：

你：“我需要记录这个React钩子的实现。创建一个旅程日志。”

克劳德：“我将为你的React钩子实现创建一个新的Journey Log文档…” *\[创建标题为“React Hooks实现”的文档\]*

你：“太好了！现在保存我们关于useEffect优化的整个对话。”

克劳德：“我将把我们关于useEffect优化的对话记录到您的文档中…” *\[保存带有代码示例的完整对话\]*

在克劳德桌面中：

你：“我正在开发一个新的用户身份验证功能。创建一个旅程日志文档来跟踪这一点。”

克劳德：“我将为您的身份验证功能创建一个新的旅程日志文档…” *\[自动创建文档\]*

你：“太好了！现在添加我们刚才讨论的JWT实现代码。”

克劳德：“我将把JWT实现添加到您的文档中…” *\[自动添加代码块\]*

在光标中：

编码时，您可以要求Cursor：

• 文档错误修复：“将此错误修复与解决方案一起保存到旅程日志中”
• 跟踪学习：“创建一个关于我使用React钩子学到的东西的旅程日志条目”
• 保存代码片段：“将此实用函数添加到我的旅程日志代码片段文档中”

工具参考

创建_文档

创建新的行程日志文档。

参数：

• title （必填）：文件标题
• content （可选）：初始内容
• tags （可选）：组织标签数组

add_block

向现有文档添加内容块。

参数：

• document_id （必填）：目标文档ID
• type （必填）：块类型（文本、代码、标题、列表、复选框、ai_conversation）
• content （必填）：阻止内容
• metadata （可选）：附加元数据（例如，代码块的语言）

捕获_对话

保存具有完整上下文的AI对话。

参数：

• document_id （必填）：目标文档ID
• conversation （必填）：包含角色和内容的消息数组
• context （可选）：附加上下文
• summary （可选）：对话摘要

list_文档

列出您的行程日志文件。

参数：

• limit （可选）：要返回的最大文档数（默认值：50）
• tags （可选）：按标签筛选
• search （可选）：在标题中搜索

get_document

检索特定文档及其所有内容。

参数：

• document_id （必填）：要检索的文档ID

故障排除

克劳德代码特定

检查MCP状态：

# In Claude Code, type:
/mcp

查看所有MCP服务器：

claude mcp list

卸下并重新安装：

claude mcp remove journey-log
claude mcp add journey-log -s user -e JOURNEY_LOG_API_KEY="your_key" -- npx -y @journey-log/mcp-server

“找不到API密钥”错误

确保 JOURNEY_LOG_API_KEY 设置正确：

• 克劳德代码：重新运行 claude mcp add 用你的钥匙命令
• Claude桌面/光标：检查配置JSON

“工具不可用”错误

1. 验证MCP服务器是否配置正确
2. 重新启动应用程序
3. 当您询问“有哪些MCP工具可用？”时，检查行程日志是否出现
4. 对于Claude Code，确保服务器显示在 claude mcp list

连接错误

• 检查您的互联网连接
• 在验证您的API密钥是否有效https://devlog.design/settings/api
• 确保您没有超过费率限制
• 尝试删除并重新添加MCP服务器

发展

要贡献或修改MCP服务器：

git clone https://github.com/journey-log/mcp-server
cd mcp-server
npm install
npm link

安全

• API密钥存储在MCP配置的本地
• 所有通信都使用HTTPS
• 密钥从不在文档或日志中公开
• 限速防止滥用

支持

• 📧 电子邮件：support@devlog.design
• 🐛 问题：
• 📖 文件： 行程日志文件

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

______________________________________________________________________

内置于❤️ 由Journey Log团队负责。快乐记录！