日志MCP服务器
一个用于日志条目的模型上下文协议(MCP)服务器,带有React Router v7 web查看器。
特性
- 📖 MCP服务器:与Claude Desktop集成用于期刊管理
- 🌐 网络观众:基于React的日志条目浏览界面
- 🚀 服务器端渲染 使用React路由器
- ⚡️ 热模块更换 (HMR)促进发展
- 🔒 TypeScript 默认情况下
- 🎉 尾风CSS 用于造型
- 📁 基于文件的存储 自动组织
入门指南
npx快速入门
无需安装即可直接运行:
# Start web viewer
npx @coji/journal-mcp --viewer
# Setup Claude Desktop integration
npx @coji/journal-mcp --setup
# Start MCP server for Claude Desktop
npx @coji/journal-mcp地方发展
安装依赖项:
pnpm install发展
使用HMR启动开发服务器:
pnpm dev您的网络查看器将在 http://localhost:5173.
生产大楼
创建生产构建:
pnpm build用法
使用npx(推荐)
# Show help
npx @coji/journal-mcp --help
# Setup Claude Desktop integration
npx @coji/journal-mcp --setup
# Verify Claude Desktop setup
npx @coji/journal-mcp --verify-setup
# Start MCP server for Claude Desktop
npx @coji/journal-mcp
# Start web viewer
npx @coji/journal-mcp --viewer
# Custom port examples
npx @coji/journal-mcp --viewer --port 8080地方发展指挥部
对于本地安装后的开发:
# Show help
node dist/index.js --help
# Setup Claude Desktop configuration
node dist/index.js --setup
# Start MCP server
node dist/index.js
# Start web viewer
node dist/index.js --viewer网络查看器将在 http://localhost:8765 (或您指定的端口)。
MCP工具
服务器为Claude Desktop提供了以下工具:
- add_entry -添加新日记条目
- search_entrys -按日期范围、标签或关键字搜索
- get_recent_entrys -获取最新条目
- list_tags -列出所有带有使用次数的标签
- get_entry_by_date -获取特定日期的条目
- get_daily_summary -获取日志统计信息
文件存储
日记账条目存储在:
- 位置:
~/.local/share/journal-mcp/entries/YYYY/MM/YYYY-MM-DD.md - 格式:带YAML frontmatter的Markdown
- 特性:自动标记提取,基于时间的组织
部署
Docker部署
docker build -t journal-mcp .
docker run -p 8765:8765 journal-mcp手动部署
部署输出 pnpm build:
├── package.json
├── pnpm-lock.yaml
├── build/
│ ├── client/ # Static assets
│ └── server/ # Server-side code______________________________________________________________________
内置于❤️ 使用React Router和MCP。
