Dev Log MCP Component

by neoliminal

280 downloads
Not rated
GitHub

About

An Developer Log MCP server for use with Cline, Roo Code, or other agentic AI tools.

Details

Author
neoliminal
Downloads
280
Categories
Developer Tools

- Read last X entries from dev_log.md via GET /read
- Append new entries with automatic timestamps via POST /write
- Automatic dependency management (Python3, pip, virtualenv)
- Background process management with PID file (devlog.pid)
- Service output logging to devlog.log

Run ./start_server.sh to automatically install dependencies, set up a virtual environment, and start the Flask service on port 5002. Use the /read endpoint to fetch recent entries and the /write endpoint to add new entries. Stop the service with ./stop_server.sh.

Dev Log MCP Component

A Model Context Protocol (MCP) component that manages a development log file. It provides endpoints for reading recent log entries and appending new entries with automatic timestamps.

Features

- Read last X entries from dev_log.md
- Append new entries with automatic timestamps and proper spacing
- Automatic dependency management
- Background process management with logging

Files

- mcp_server.py - Flask implementation of dev log endpoints
- dev_rules.md - Development guidelines and logging format rules
- dev_log.md - The log file containing timestamped entries
- requirements.txt - Python dependencies
- start_server.sh - Dev log service startup script with dependency installation
- stop_server.sh - Dev log service shutdown script

Installation & Usage

The service handles all dependency installation automatically. Just run:

./start_server.sh

This will:
1. Check and install required system dependencies (Python3, pip)
2. Set up a virtual environment
3. Install Python dependencies
4. Start the dev log service in the background
5. Create a log file at devlog.log

To stop the service:

./stop_server.sh

API Endpoints

Read Log Entries

GET http://localhost:5002/read?lines=10
- lines (optional): Number of recent entries to return (default: 10) - Returns: JSON array of log entries

Write Log Entry

POST http://localhost:5002/write
Content-Type: application/json

{
"entry": "Your log message here"
}


- Automatically prepends timestamp in format: "YYYY-MM-DD HH:MM:SS"
- Adds proper spacing between entries
- Returns: Success/error status

Monitoring

- Process ID is stored in devlog.pid
- Service output is logged to devlog.log
- Check service status: ps -p $(cat devlog.pid)

Log Format

Each entry in dev_log.md follows this format:

## YYYY-MM-DD HH:MM:SS: Your log message here

Entries are separated by newlines for better readability. See dev_rules.md for detailed logging guidelines.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.