Skip to main content
Glama
Adithi1367

Personal-reflection-mcp

by Adithi1367
README.md
# Personal Reflection MCP
A FastMCP server for journaling, habit tracking, and task management with SQLite storage.
## Features

- Add journal entries
- View all journal entries
- Search journal entries
- View journal statistics
- Generate recent reflections
- Create and track habits
- Mark habits as completed
- View habit statistics
- Create tasks/goals
- Mark tasks as completed
- View all tasks

## Project Structure

```
personal_reflection_mcp/
│
├── server.py
├── tools.py
├── journal.py
├── habits.py
├── tasks.py
├── reflection.py
├── stats.py
├── database.py
├── schema.py
├── requirements.txt
├── Dockerfile
├── .gitignore
│
└── data/
    └── reflection.db
```

## Installation

Clone the repository:

```bash
git clone https://github.com/Adithi1367/Personal-reflection-mcp.git
cd Personal-reflection-mcp
```

Create a virtual environment:

```bash
python -m venv .venv
```

Activate it:

**Windows**

```bash
.venv\Scripts\activate
```

Install dependencies:

```bash
pip install -r requirements.txt
```

## Run the MCP Server

```bash
fastmcp run server.py
```

## Run with Docker

Build the image:

```bash
docker build -t personal-reflection-mcp .
```

Run the container:

```bash
docker run personal-reflection-mcp
```

## Technologies Used

- Python
- FastMCP
- SQLite
- Docker

## License

This project is for learning and personal use.