optimized memory mcp serverv2

Local 2025-09-01 00:15:24 0

Knowledge And Memory @AgentWong/optimized-memory-mcp-serverv2

A Python-based server that implements the Model Context Protocol to interface with Claude Desktop as an MCP client, supporting interaction through efficient memory management.

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: 1. Clone and setup Python environment 2. Install dependencies: pip install -r requirements.txt 3. Configure database: export DATABASE_URL=sqlite:///path/to/db.db 4. Initialize database: alembic upgrade head 5. 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