welfvh/welf-mcp

welf-mcp

An MCP (Model Context Protocol) server for building a personal mirror - a comprehensive context system that captures and organizes personal work, journaling, psychology, emotional patterns, and behavioral insights.

Vision

This project aims to create a deeply agentic MCP server that builds and maintains a mirror of yourself. It provides Claude with perfect context on your most important work, thoughts, and patterns, enabling more personalized and context-aware interactions.

Core Capabilities

• Document Management: Receive and organize documents and summaries from daily interactions
• Progressive Summarization: Build coherent profiles through iterative summarization
• Context Building: Maintain comprehensive context about work, projects, and personal development
• Pattern Recognition: Track behavioral patterns, emotional states, and personal growth
• Journaling Integration: Seamlessly integrate journaling and self-reflection data

Technical Architecture

MCP Server Components

1. Tools

   • capture_context: Capture and store contextual information
   • update_profile: Update user profile with new insights
   • query_context: Retrieve relevant context for conversations
   • summarize_period: Create periodic summaries of captured data

2. Resources

   • User profiles and personas
   • Document storage and retrieval
   • Context graphs and relationships
   • Historical summaries and insights

3. Authentication

   • OAuth 2.1 with PKCE
   • User-specific access controls
   • Secure token management

Data Organization

welf-mcp/
├── profiles/          # User profiles and personas
├── documents/         # Captured documents and notes
├── summaries/         # Progressive summaries
├── patterns/          # Behavioral and emotional patterns
└── contexts/          # Contextual relationships

Getting Started

Prerequisites

• Node.js 18+
• TypeScript 5+
• Claude Pro/Max/Teams account with MCP access

Installation

npm install

Development

npm run dev

Building

npm run build
npm start

Usage

Once deployed, the MCP server integrates with Claude to:

1. Automatically capture relevant information from conversations
2. Build and maintain your personal profile
3. Provide contextual awareness in future interactions
4. Track patterns and insights over time

Philosophy

This project embodies the vision of creating a true digital mirror - not just a data repository, but an intelligent system that understands and reflects your intellectual and emotional journey. It serves as a bridge between your daily interactions with AI and a deeper understanding of yourself.

Contributing

This is a personal project focused on building a specific vision of self-reflection and context management. Issues and discussions are welcome for those interested in similar approaches to personal AI integration.

License

MIT