Agentwong Optimized Memory MCP Serverv2

🚀 Optimized Memory MCP Server v2

This is a personal project aimed at testing Claude AI's ability to write its own MCP server code. It's a Python-based implementation of the Model Context Protocol (MCP) server, designed to work with Claude Desktop as an MCP client.

🚀 Quick Start

Prerequisites

1. Ensure Python 3.13.1 is installed:

python --version  # Should display 3.13.1

2. Install uvx if not already installed:

pip install uvx

3. Clone this repository:

git clone https://github.com/AgentWong/optimized-memory-mcp-serverv2.git
cd optimized-memory-mcp-serverv2

4. Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Unix/macOS systems
# Or on Windows systems
.venv\Scripts\activate

5. Install dependencies:

pip install -r requirements.txt
pip install -r requirements-dev.txt  # For development purposes

6. Initialize the database:

alembic upgrade head

7. Run the server:

uvx run python -m src.main

✨ Features

This project is a Python-based implementation of the Model Context Protocol (MCP) server, designed to work with Claude Desktop as an MCP client. It's a personal project aimed at testing Claude AI's ability to write its own MCP server code.

📦 Installation

The installation steps are included in the Quick Start section above.

📚 Documentation

Project Structure

mcp_server/
├── README.md                 # Project documentation
├── requirements.txt          # Project dependencies
├── server.py                # Main server implementation file
├── tests/                   # Test directory
│   ├── __init__.py
│   ├── test_resources.py
│   └── test_tools.py
├── docs/                    # Documentation directory
│   └── CONVENTIONS.md       # Implementation convention documentation
└── src/                     # Source code directory
    ├── __init__.py
    ├── resources/          # Resource implementation
    │   └── __init__.py
    ├── tools/              # Tool implementation
    │   └── __init__.py
    └── utils/              # Helper functions
        └── __init__.py

Development

Follow the implementation details and best practices outlined in docs/CONVENTIONS.md.