@shoutoutlabs/memory-bank-graph-mcp

A Model Context Protocol (MCP) server that provides intelligent codebase analysis and dependency mapping for Cursor IDE. This package creates and manages a SQLite-based graph database of your project's structure, dependencies, and relationships.

Features

• Intelligent Project Detection: Automatically detects project root and creates memory database
• Graph Database: SQLite-based graph storage for project structure and dependencies
• MCP Integration: Full Model Context Protocol compliance for Cursor IDE
• Auto-Initialization: Automatic database schema creation and setup
• Flexible Configuration: Command-line and environment variable options

Installation

npm install @shoutoutlabs/memory-bank-graph-mcp

Quick Start

1. Initialize the Database

# Auto-detect project root and initialize database
npx @shoutoutlabs/memory-bank-graph-mcp --init

# Or using npm script
npm run init

2. Start the MCP Server

# Start the server (auto-detects project root)
npx @shoutoutlabs/memory-bank-graph-mcp

# Or using npm script
npm start

Configuration

Auto-Detection Strategy

The server automatically detects your project root by looking for these indicators:

• package.json
• .git directory
• src directory
• memory-bank directory
• memory-bank-graph directory

Manual Configuration

Command Line Options

# Specify project root
npx @shoutoutlabs/memory-bank-graph-mcp --project-root=/path/to/your/project

# Initialize database
npx @shoutoutlabs/memory-bank-graph-mcp --init --project-root=/path/to/your/project

Environment Variables

# Set project root
export PROJECT_ROOT=/path/to/your/project
npx @shoutoutlabs/memory-bank-graph-mcp

# Set custom database path
export MCP_SQLITE_PATH=/path/to/custom/database.db
npx @shoutoutlabs/memory-bank-graph-mcp

Database Location

The memory database is automatically created in your project's memory directory structure:

your-project/
├── memory/
│   └── db/
│       └── memory.db
└── ...

MCP Tools

This server provides the following MCP tools:

Graph Management

• graph_init - Initialize or update database schema
• graph_upsert_version - Create or update graph nodes
• graph_add_edge - Add relationships between nodes
• graph_search_nodes - Search for nodes in the graph
• graph_current_requirements - Get current project requirements

Project Management

• project_create - Create or version a project node
• service_create - Create a service and link to project
• requirement_propose - Propose new requirements
• requirement_accept - Accept requirements into canonical
• decision_record - Record architectural decisions
• slo_upsert - Create or update Service Level Objectives

Utilities

• snapshot_create - Create project snapshots
• housekeeping_expire_ephemeral - Clean up expired nodes

Integration with Cursor IDE

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "memory-bank-graph": {
      "command": "npx",
      "args": ["@shoutoutlabs/memory-bank-graph-mcp"],
      "env": {
        "PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

Development

Prerequisites

• Node.js 18.0.0 or higher
• npm or yarn

Local Development

# Clone the repository
git clone https://github.com/shoutoutlabs/memory-bank-graph.git
cd memory-bank-graph/local-graph-mcp

# Install dependencies
npm install

# Start development server
npm start

# Initialize database
npm run init

API Reference

Command Line Interface

npx @shoutoutlabs/memory-bank-graph-mcp [options]

Options:
  --project-root=<path>    Set project root directory
  --init                   Initialize database schema
  --help                   Show help information

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | PROJECT_ROOT | Project root directory | Auto-detected | | MCP_SQLITE_PATH | Custom database path | {PROJECT_ROOT}/memory/db/memory.db |

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

Changelog

See CHANGELOG.md for a list of changes and version history.

Made with ❤️ by ShoutOUT Labs