Optimized Memory MCP Server v2

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

[!CAUTION] This project has been archived due to faulty project specifications and AI direction that led to endless looping behavior.

Overview

This MCP server implementation focuses on:

Efficient memory management for large-scale infrastructure tracking
Comprehensive resource and tool implementations following MCP patterns
Full Claude Desktop compatibility
SQLite-based persistent storage with connection pooling
Robust error handling and resource cleanup

Features

MCP Resources
- Entity management (listing, retrieval, relationships)
- Provider resource tracking
- Ansible collection management
- Version tracking
- Full-text search capabilities
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
- Extensive logging

Project Structure

.
├── src/
│   ├── resources/          # MCP resource implementations
│   ├── tools/             # MCP tool implementations
│   ├── 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

Requirements

Python 3.13.1 or higher
SQLite 3.x
uvx server

Quick Start

See our Environment Setup Guide for detailed installation instructions.

Key steps:

Clone and setup Python environment
Install dependencies: pip install -r requirements.txt
Configure database: export DATABASE_URL=sqlite:///path/to/db.db
Initialize database: alembic upgrade head
Start server: uvx run python -m src.main

Usage

Start the server:
```
uvx run python -m src.main
```
Configure Claude Desktop:
- Set MCP server URL to http://localhost:8000
- Enable MCP protocol in Claude settings
Verify connection:
```
curl http://localhost:8000/health
```

Development Setup

Install development dependencies:
```
pip install -r requirements-dev.txt
```
Set up pre-commit hooks:
```
pre-commit install
```
Run tests:
```
pytest
```
Check code quality:
```
flake8
mypy .
```

Contributing

Fork the repository
Create a feature branch
Make your changes following our conventions
Run tests and linting
Submit a pull request

Documentation

Environment Setup Guide - Installation and configuration
MCP Usage Guide - Using MCP resources and tools
API Documentation - API reference
Configuration Guide - Server configuration
Development Guide - Contributing guidelines
Database Schema - Data model reference
Troubleshooting Guide - Common issues and solutions

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Claude Desktop team for MCP protocol specifications
Contributors to the FastMCP library
SQLAlchemy team for database tooling