Dev Log MCP Component

by neoliminal

280 downloads Not rated yet

About

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

Explore

- 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

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

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.