Files
my-pal-mcp-server/docs/logging.md
Beehive Innovations 4151c3c3a5 Migration from Docker to Standalone Python Server (#73)
* Migration from docker to standalone server
Migration handling
Fixed tests
Use simpler in-memory storage
Support for concurrent logging to disk
Simplified direct connections to localhost

* Migration from docker / redis to standalone script
Updated tests
Updated run script
Fixed requirements
Use dotenv
Ask if user would like to install MCP in Claude Desktop once
Updated docs

* More cleanup and references to docker removed

* Cleanup

* Comments

* Fixed tests

* Fix GitHub Actions workflow for standalone Python architecture

- Install requirements-dev.txt for pytest and testing dependencies
- Remove Docker setup from simulation tests (now standalone)
- Simplify linting job to use requirements-dev.txt
- Update simulation tests to run directly without Docker

Fixes unit test failures in CI due to missing pytest dependency.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Remove simulation tests from GitHub Actions

- Removed simulation-tests job that makes real API calls
- Keep only unit tests (mocked, no API costs) and linting
- Simulation tests should be run manually with real API keys
- Reduces CI costs and complexity

GitHub Actions now only runs:
- Unit tests (569 tests, all mocked)
- Code quality checks (ruff, black)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Fixed tests

* Fixed tests

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-06-18 23:41:22 +04:00

1.6 KiB

Logging

Quick Start - Follow Logs

The easiest way to monitor logs is to use the -f flag when starting the server:

# Start server and automatically follow MCP logs
./run-server.sh -f

This will start the server and immediately begin tailing the MCP server logs.

Log Files

Logs are stored in the logs/ directory within your project folder:

  • mcp_server.log - Main server operations, API calls, and errors
  • mcp_activity.log - Tool calls and conversation tracking

Log files rotate automatically when they reach 20MB, keeping up to 10 rotated files.

Viewing Logs

To monitor MCP server activity:

# Follow logs in real-time
tail -f logs/mcp_server.log

# View last 100 lines
tail -n 100 logs/mcp_server.log

# View activity logs (tool calls only)
tail -f logs/mcp_activity.log

# Search for specific patterns
grep "ERROR" logs/mcp_server.log
grep "tool_name" logs/mcp_activity.log

Log Level

Set verbosity with LOG_LEVEL in your .env file:

# Options: DEBUG, INFO, WARNING, ERROR
LOG_LEVEL=INFO
  • DEBUG: Detailed information for debugging
  • INFO: General operational messages (default)
  • WARNING: Warning messages
  • ERROR: Only error messages

Log Format

Logs use a standardized format with timestamps:

2024-06-14 10:30:45,123 - module.name - INFO - Message here

Tips

  • Use ./run-server.sh -f for the easiest log monitoring experience
  • Activity logs show only tool-related events for cleaner output
  • Main server logs include all operational details
  • Logs persist across server restarts