Journal MCP

🚀 日誌MCP服務器

日誌MCP服務器是一款支持日誌條目管理的Model Context Protocol (MCP) 服務器，搭配 React Router v7 網絡查看器，可提供便捷的日誌瀏覽體驗。

✨ 主要特性

• 📖 MCP服務器：與Claude Desktop集成，實現日誌管理功能。
• 🌐 網絡查看器：基於React的界面，方便瀏覽日誌條目。
• 🚀 服務器端渲染：藉助React Router實現服務器端渲染。
• ⚡️ 熱模塊替換（HMR）：開發過程中支持熱模塊替換，提升開發效率。
• 🔒 默認使用TypeScript：保證代碼的類型安全。
• 🎉 TailwindCSS樣式：採用TailwindCSS進行樣式設計。
• 📁 基於文件的存儲：自動組織日誌文件，方便管理。

🚀 快速開始

使用npx快速啟動

無需安裝，直接運行：

# 啟動網絡查看器
npx @coji/journal-mcp --viewer

# 設置Claude Desktop集成
npx @coji/journal-mcp --setup

# 為Claude Desktop啟動MCP服務器
npx @coji/journal-mcp

本地開發

安裝依賴：

pnpm install

開發模式

啟動帶有熱模塊替換的開發服務器：

pnpm dev

網絡查看器將在 http://localhost:5173 可用。

生產環境構建

創建生產環境構建：

pnpm build

💻 使用示例

使用npx（推薦）

# 顯示幫助信息
npx @coji/journal-mcp --help

# 設置Claude Desktop集成
npx @coji/journal-mcp --setup

# 驗證Claude Desktop設置
npx @coji/journal-mcp --verify-setup

# 為Claude Desktop啟動MCP服務器
npx @coji/journal-mcp

# 啟動網絡查看器
npx @coji/journal-mcp --viewer

# 自定義端口示例
npx @coji/journal-mcp --viewer --port 8080

本地開發命令

本地安裝後進行開發：

# 顯示幫助信息
node dist/index.js --help

# 設置Claude Desktop配置
node dist/index.js --setup

# 啟動MCP服務器
node dist/index.js

# 啟動網絡查看器
node dist/index.js --viewer

網絡查看器將在 http://localhost:8765（或你指定的端口）可用。

📚 詳細文檔

MCP工具

服務器為Claude Desktop提供以下工具：

1. add_entry - 添加新的日誌條目
2. search_entries - 按日期範圍、標籤或關鍵詞搜索
3. get_recent_entries - 獲取最近的日誌條目
4. list_tags - 列出所有標籤及其使用次數
5. get_entry_by_date - 獲取特定日期的日誌條目
6. get_daily_summary - 獲取日誌統計信息

文件存儲

日誌條目存儲在以下位置：

• 位置：~/.local/share/journal-mcp/entries/YYYY/MM/YYYY-MM-DD.md
• 格式：帶有YAML前置元數據的Markdown格式
• 特性：自動提取標籤，按時間組織文件

🚀 部署

Docker部署

docker build -t journal-mcp .
docker run -p 8765:8765 journal-mcp

手動部署

部署 pnpm build 的輸出：

├── package.json
├── pnpm-lock.yaml
├── build/
│   ├── client/    # 靜態資源
│   └── server/    # 服務器端代碼

本項目使用 React Router 和 MCP 精心打造 ❤️。