Optimized Memory MCP Serverv2

🚀 Optimized Memory MCP Server v2

A high-performance Model Context Protocol (MCP) server implementation based on Python, optimized for integration with Claude Desktop. This server provides efficient memory management and powerful basic component tracking capabilities.

⚠️ Important Note

This project has been archived due to defects in the project specification and AI direction, resulting in infinite loop behavior.

🚀 Quick Start

Refer to our Environment Setup Guide for detailed installation instructions.

Key steps:

1. Clone the code and set up the Python environment.
2. Install dependencies: pip install -r requirements.txt
3. Configure the database: export DATABASE_URL=sqlite:///path/to/db.db
4. Initialize the database: alembic upgrade head
5. Start the server: uvx run python -m src.main

✨ Features

MCP Resources

• Entity management (listing, retrieval, relationships)
• Provider resource tracking
• Ansible collection management
• Version tracking
• Full-text search functionality

MCP Tools

• Entity creation and management
• Observation tracking
• Provider registration
• Ansible module integration
• Infrastructure analysis tools

Core Components

• FastMCP server implementation
• SQLite database with connection pooling
• Comprehensive error handling
• Automatic resource cleanup
• Detailed logging

📦 Installation

Requirements

• Python 3.13.1 or higher
• SQLite 3.x
• uvx server

💻 Usage Examples

Basic Usage

1. Start the server:

   uvx run python -m src.main
   

2. Configure Claude Desktop:

   • Set the MCP server URL to http://localhost:8000
   • Enable the MCP protocol in Claude settings.

3. Verify the connection:

   curl http://localhost:8000/health
   

Development Setup

1. Install development dependencies:

   pip install -r requirements-dev.txt
   

2. Set up pre-commit hooks:

   pre-commit install
   

3. Run tests:

   pytest tests/
   

4. Format the code:

   black .
   

📚 Documentation

• Environment Setup Guide - Click here
• Usage Guide - Click here
• Development Guide - Click here
• Testing Guide - Click here

🤝 Contribution Guidelines

Please refer to the Contribution Guidelines to learn how to contribute to this project.

📁 Project Structure

.
├── src/
│   ├── resources/          # MCP resource implementation
│   ├── tools/             # MCP tool implementation
│   ├── db/                # Database management
│   ├── utils/             # Utility functions
│   └── server.py          # Main server implementation
├── tests/
│   ├── resources/         # Resource tests
│   ├── tools/             # Tool tests
│   └── integration/       # Integration tests
├── docs/                  # Documentation
├── migrations/            # Database migrations
└── requirements/          # Project dependencies