{"id":48832307,"url":"https://github.com/1999azzar/project-guardian-mcp-server","last_synced_at":"2026-04-18T07:33:19.207Z","repository":{"id":315245252,"uuid":"1058702970","full_name":"1999AZZAR/project-guardian-mcp-server","owner":"1999AZZAR","description":"A focused Model Context Protocol (MCP) server designed as your project's memory system and workflow guardian. This server provides streamlined database operations and advanced knowledge graph capabilities for intelligent project management. ","archived":false,"fork":false,"pushed_at":"2026-01-27T13:47:05.000Z","size":344,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-28T00:57:07.482Z","etag":null,"topics":["database","mcp","mcp-server","mcp-tools"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/1999AZZAR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-17T12:44:45.000Z","updated_at":"2026-01-27T13:48:53.000Z","dependencies_parsed_at":"2025-09-17T14:43:35.713Z","dependency_job_id":"daaa8a65-5fa0-42b9-a1d7-5c846679cab8","html_url":"https://github.com/1999AZZAR/project-guardian-mcp-server","commit_stats":null,"previous_names":["1999azzar/database-mcp-server","1999azzar/project-guardian-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/1999AZZAR/project-guardian-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fproject-guardian-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fproject-guardian-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fproject-guardian-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fproject-guardian-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1999AZZAR","download_url":"https://codeload.github.com/1999AZZAR/project-guardian-mcp-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Fproject-guardian-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31815080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","mcp","mcp-server","mcp-tools"],"created_at":"2026-04-14T21:01:56.280Z","updated_at":"2026-04-14T21:01:57.794Z","avatar_url":"https://github.com/1999AZZAR.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Project Guardian MCP\n\nA focused Model Context Protocol (MCP) server designed as your project's memory system and workflow guardian. This server provides streamlined database operations and advanced knowledge graph capabilities for intelligent project management, with exactly 17 tools, 10 resources, and 28 prompts to maintain clarity and focus.\n\n## Table of Contents\n\n- [Features](#features)\n  - [Project Guardian Memory System](#project-guardian-memory-system)\n  - [Streamlined Database Operations](#streamlined-database-operations)\n  - [AI Guidance System](#ai-guidance-system)\n  - [Advanced Features](#advanced-features)\n  - [Enterprise Features](#enterprise-features)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Available Tools](#available-tools)\n  - [Database Operations (7 tools)](#database-operations-7-tools)\n  - [Project Guardian Memory Tools (10 tools)](#project-guardian-memory-tools-10-tools)\n- [AI Guidance System](#ai-guidance-system)\n  - [Available Resources](#available-resources)\n  - [Available Prompts](#available-prompts)\n  - [How AI Models Use Guidance](#how-ai-models-use-guidance)\n- [Usage Examples](#usage-examples)\n  - [Project Guardian Setup](#project-guardian-setup)\n  - [Project Management Workflow](#project-management-workflow)\n  - [Database Operations](#database-operations)\n- [Configuration](#configuration)\n  - [For Cursor IDE](#for-cursor-ide)\n  - [For Claude Desktop](#for-claude-desktop)\n- [Project Structure](#project-structure)\n- [Development](#development)\n- [License](#license)\n\n## Features\n\n### Project Guardian Memory System\n- **Knowledge Graph**: Maintain project entities, relationships, and observations\n- **Entity Management**: Projects, tasks, people, resources with rich metadata\n- **Relationship Mapping**: Dependencies, ownership, blockers, and connections\n- **Observation Tracking**: Contextual notes and progress updates\n- **Semantic Search**: Full-text search across all project knowledge\n- **Memory Persistence**: Automatic persistence in SQLite database\n\n### Streamlined Database Operations\n- **Single Database**: Uses only `memory.db` for all operations\n- **Core CRUD**: Essential database operations (query, insert, update, delete)\n- **SQL Execution**: Direct SQL query execution\n- **Data Transfer**: Import/export CSV and JSON files\n- **17 Tools Total**: Focused toolset for maximum clarity\n\n### AI Guidance System\n- **10 Resources**: Templates, best practices, cached data, and comprehensive project status\n- **27 Prompts**: Comprehensive pre-built workflows for all aspects of project management\n- **Expert Guidance**: Step-by-step instructions for complex operations\n- **Contextual Help**: Adaptive prompts based on user needs\n- **Knowledge Base**: Comprehensive project management wisdom\n\n### Advanced Features\n- **Schema Validation**: Comprehensive input validation with Zod schemas\n- **Error Handling**: Detailed error messages and graceful failure handling\n- **Connection Management**: Automatic connection pooling and cleanup\n- **File Integration**: Seamless integration with filesystem operations\n- **Performance**: Optimized for large datasets and batch operations\n\n### Enterprise Features\n- **TypeScript**: Fully typed with comprehensive error handling\n- **Input Validation**: Zod schema validation for all parameters\n- **Error Recovery**: Graceful error handling with detailed error messages\n- **Resource Management**: Automatic cleanup of connections and resources\n- **Testing**: Comprehensive Jest test suite with high coverage\n\n## Requirements\n\n- **Node.js**: \u003e= 18.0.0\n- **npm**: Latest stable version\n- **SQLite3**: Automatically installed as dependency\n\n## Installation\n\n1. **Clone the repository:**\n```bash\ngit clone https://github.com/1999AZZAR/project-guardian-mcp-server.git\ncd project-guardian-mcp-server\n```\n\n2. **Install dependencies:**\n```bash\nnpm install\n```\n\n3. **Build the project:**\n```bash\nnpm run build\n```\n\n4. **Test the server:**\n```bash\nnpm start\n```\n\n\n## Available Tools\n\nThis MCP server provides **exactly 17 focused tools** for project guardianship:\n\n### Database Operations (7 tools)\n\n#### `execute_sql` - Execute SQL Query\nExecute raw SQL queries on memory.db.\n\n**Parameters:**\n- `query` (required): SQL query string\n- `parameters` (optional): Query parameters array\n\n#### `query_data` - Query Table Data\nQuery data from memory.db tables with filtering and pagination.\n\n**Parameters:**\n- `table` (required): Table name\n- `conditions` (optional): WHERE conditions object\n- `limit` (optional): Maximum rows to return\n- `offset` (optional): Number of rows to skip\n- `orderBy` (optional): Column to sort by\n- `orderDirection` (optional): Sort direction (\"ASC\" or \"DESC\")\n\n#### `insert_data` - Insert Records\nInsert records into memory.db table.\n\n**Parameters:**\n- `table` (required): Table name\n- `records` (required): Array of record objects to insert\n\n#### `update_data` - Update Records\nUpdate records in memory.db table.\n\n**Parameters:**\n- `table` (required): Table name\n- `conditions` (required): WHERE conditions for records to update\n- `updates` (required): Fields to update\n\n#### `delete_data` - Delete Records\nDelete records from memory.db table.\n\n**Parameters:**\n- `table` (required): Table name\n- `conditions` (required): WHERE conditions for records to delete\n\n#### `import_data` - Import Data\nImport data from CSV or JSON file into memory.db table.\n\n**Parameters:**\n- `table` (required): Target table name\n- `filePath` (required): Path to source file\n- `format` (optional): File format (\"csv\" or \"json\")\n- `options` (optional): Import options (delimiter, hasHeader)\n\n#### `export_data` - Export Data\nExport memory.db table data to CSV or JSON file.\n\n**Parameters:**\n- `table` (required): Source table name\n- `filePath` (required): Output file path\n- `format` (optional): Output format (\"csv\" or \"json\")\n- `conditions` (optional): WHERE conditions to filter export\n- `options` (optional): Export options (delimiter, includeHeader)\n\n### Project Guardian Memory Tools (10 tools)\n\n#### `initialize_memory` - Initialize Memory System\nSet up the project memory database schema and tables.\n\n**Parameters:** None\n\n#### `create_entity` - Create Project Entities\nCreate entities in the project knowledge graph (supports single or batch).\n\n**Parameters:**\n- `entities` (required): Array of entity objects\n  - `name`: Entity name\n  - `entityType`: Type (project, task, person, resource)\n  - `observations`: Array of notes about the entity\n\n#### `create_relation` - Create Entity Relationships\nCreate relationships between project entities (supports single or batch).\n\n**Parameters:**\n- `relations` (required): Array of relation objects\n  - `from`: Source entity name\n  - `to`: Target entity name\n  - `relationType`: Relationship type (depends_on, blocks, owns, etc.)\n\n#### `add_observation` - Add Entity Observations\nAdd observations/notes to project entities (supports single or batch).\n\n**Parameters:**\n- `observations` (required): Array of observation objects\n  - `entityName`: Target entity name\n  - `contents`: Array of observation strings to add\n\n#### `delete_entity` - Delete Project Entities\nRemove entities and their relations from project memory (supports single or batch).\n\n**Parameters:**\n- `entityNames` (required): Array of entity names to delete\n\n#### `delete_observation` - Remove Entity Observations\nRemove specific observations from entities (supports single or batch).\n\n**Parameters:**\n- `deletions` (required): Array of deletion objects\n  - `entityName`: Target entity name\n  - `observations`: Array of observation strings to remove\n\n#### `delete_relation` - Delete Entity Relationships\nRemove relationships between project entities (supports single or batch).\n\n**Parameters:**\n- `relations` (required): Array of relation objects to delete\n  - `from`: Source entity name\n  - `to`: Target entity name\n  - `relationType`: Relationship type to delete\n\n#### `read_graph` - Read Project Knowledge Graph\nRetrieve the entire project knowledge graph with all entities and relationships.\n\n**Parameters:** None\n\n#### `search_nodes` - Search Project Knowledge\nSearch for entities and relations matching a query across names, types, and content.\n\n**Parameters:**\n- `query` (required): Search term\n\n#### `open_node` - Get Entity Details\nRetrieve detailed information about project entities (supports single or batch).\n\n**Parameters:**\n- `names` (required): Array of entity names to retrieve\n\n## AI Guidance System\n\nProject Guardian MCP includes comprehensive resources and prompts to help AI models effectively use the toolset for project management.\n\n### Available Resources\n\nProject Guardian provides **10 key resources** that AI models can read to understand project management concepts, access cached data, and get comprehensive project insights:\n\n#### `project-guardian://templates/entity-types`\nStandard entity types for project management with examples and usage guidelines.\n\n#### `project-guardian://templates/relationship-types`\nCommon relationship types between project entities with practical examples.\n\n#### `project-guardian://templates/project-workflows`\nStandard workflows for using Project Guardian tools in different scenarios.\n\n#### `project-guardian://templates/best-practices`\nComprehensive best practices guide for effective project knowledge management.\n\n#### `project-guardian://status/current-graph`\nCurrent state of the project knowledge graph with summary statistics.\n\n#### `project-guardian://cache/recent-activities`\nRecently performed project management activities and updates for tracking progress.\n\n#### `project-guardian://cache/workflow-templates`\nFrequently used workflow templates with examples and implementation guidance.\n\n#### `project-guardian://metrics/project-stats`\nStatistical overview of project entities, relationships, and activities with health metrics.\n\n#### `project-guardian://cache/team-members`\nCached information about project team members and their roles within the organization.\n\n#### `project-guardian://status/recent-changes`\nRecent additions, updates, and modifications to the knowledge graph for audit and monitoring.\n\n### Available Prompts\n\nProject Guardian offers **28 specialized prompts** covering all aspects of comprehensive project management, from basic setup to advanced enterprise workflows:\n\n#### Core Project Management\n#### `project-setup` - Project Initialization\n**Arguments:**\n- `project_name` (required): Name of the project\n- `team_members` (optional): Comma-separated list of team members\n\nProvides step-by-step guidance for setting up a new project structure with appropriate entities and relationships.\n\n#### `sprint-planning` - Sprint Planning\n**Arguments:**\n- `sprint_name` (required): Name/number of the sprint\n- `duration_days` (optional): Sprint duration in days\n\nGuides through comprehensive sprint planning including task breakdown, dependencies, and capacity planning.\n\n#### `progress-update` - Progress Tracking\n**Arguments:**\n- `task_name` (required): Name of the task to update\n- `progress_notes` (required): Progress update description\n\nStructured process for updating task progress and managing dependencies.\n\n#### `retrospective` - Project Retrospective\n**Arguments:**\n- `time_period` (required): Time period being reviewed (e.g., \"last sprint\", \"Q1\")\n\nComprehensive retrospective process including data analysis, pattern identification, and improvement action creation.\n\n#### Quality \u0026 Process Management\n#### `code-review` - Code Review Process\n**Arguments:**\n- `pull_request_title` (required): Title of the pull request being reviewed\n- `reviewer_name` (optional): Name of the reviewer\n\nStructured code review process with technical checklists, issue documentation, and approval workflows.\n\n#### `bug-tracking` - Bug Management\n**Arguments:**\n- `bug_description` (required): Description of the bug or issue\n- `severity_level` (optional): Critical, High, Medium, or Low severity\n\nComplete bug tracking workflow from discovery to resolution with impact analysis and stakeholder communication.\n\n#### `technical-debt-assessment` - Technical Debt Analysis\n**Arguments:**\n- `component_name` (required): Name of the component or codebase being assessed\n- `assessment_scope` (optional): Scope of assessment (file, module, system)\n\nComprehensive technical debt identification, prioritization, and remediation planning.\n\n#### Release \u0026 Deployment Management\n#### `release-planning` - Release Planning\n**Arguments:**\n- `release_version` (required): Version number for the release (e.g., \"v2.1.0\")\n- `release_date` (optional): Target release date\n\nComplete release planning process including quality gates, risk assessment, and deployment coordination.\n\n#### Risk \u0026 Change Management\n#### `risk-assessment` - Risk Management\n**Arguments:**\n- `risk_description` (required): Description of the risk\n- `impact_level` (optional): High, Medium, or Low impact\n\nComplete workflow for documenting risks, identifying impacts, and developing mitigation strategies.\n\n#### `change-management` - Change Control\n**Arguments:**\n- `change_description` (required): Description of the proposed change\n- `impact_assessment` (optional): High, Medium, or Low impact assessment\n\nStructured change management process with impact analysis, approval workflows, and implementation tracking.\n\n#### Team \u0026 Resource Management\n#### `team-productivity` - Productivity Analysis\n**Arguments:**\n- `timeframe` (required): Time period to analyze (week, month, quarter)\n- `focus_area` (optional): Area to focus on (velocity, quality, collaboration)\n\nTeam productivity assessment with performance metrics, root cause analysis, and improvement planning.\n\n#### `resource-allocation` - Resource Planning\n**Arguments:**\n- `resource_type` (required): Type of resource (human, infrastructure, budget)\n- `planning_horizon` (optional): Planning timeframe (sprint, quarter, year)\n\nResource allocation optimization with capacity planning, gap analysis, and utilization tracking.\n\n#### Documentation \u0026 Communication\n#### `stakeholder-communication` - Communication Management\n**Arguments:**\n- `communication_type` (required): Type of communication (status_update, issue_alert, milestone_reached)\n- `audience` (optional): Target audience (team, management, client, all)\n\nStakeholder communication planning and execution with audience-specific strategies and effectiveness tracking.\n\n#### `documentation-management` - Documentation Updates\n**Arguments:**\n- `documentation_type` (required): Type of documentation (api, user_guide, technical_spec)\n- `update_reason` (optional): Reason for documentation update\n\nDocumentation maintenance process with content planning, review workflows, and publishing coordination.\n\n#### Requirements \u0026 Planning Management\n#### `requirements-gathering` - Requirements Gathering\n**Arguments:**\n- `requirement_type` (required): Type of requirements (functional, non-functional, business, technical)\n- `stakeholders` (optional): Comma-separated list of key stakeholders\n\nGuides through comprehensive requirements gathering process with stakeholder management and requirement categorization.\n\n#### `user-story-management` - User Story Management\n**Arguments:**\n- `feature_name` (required): Name of the feature or epic\n- `user_role` (optional): Primary user role (e.g., \"customer\", \"admin\", \"developer\")\n\nStructured process for creating, managing, and prioritizing user stories with acceptance criteria and dependencies.\n\n#### Quality \u0026 Technical Management\n#### `testing-strategy` - Testing Strategy Development\n**Arguments:**\n- `application_type` (required): Type of application (web, mobile, api, desktop)\n- `criticality_level` (optional): Business criticality (critical, high, medium, low)\n\nComprehensive testing strategy development including automated testing, quality gates, and risk-based testing.\n\n#### `security-assessment` - Security Assessment\n**Arguments:**\n- `assessment_scope` (required): Scope of security assessment (application, infrastructure, data)\n- `compliance_requirements` (optional): Compliance standards (GDPR, HIPAA, SOC2, etc.)\n\nSecurity assessment framework with vulnerability management, compliance verification, and security controls implementation.\n\n#### `performance-optimization` - Performance Optimization\n**Arguments:**\n- `performance_metric` (required): Primary metric to optimize (response_time, throughput, resource_usage)\n- `optimization_goal` (optional): Specific performance target or improvement percentage\n\nPerformance monitoring setup, bottleneck identification, and optimization implementation with continuous monitoring.\n\n#### `ci-cd-setup` - CI/CD Pipeline Setup\n**Arguments:**\n- `pipeline_type` (required): Type of pipeline (build, test, deploy, full_ci_cd)\n- `target_platform` (optional): Deployment target (aws, azure, gcp, kubernetes, heroku)\n\nComplete CI/CD pipeline setup including quality gates, rollback procedures, and security integration.\n\n#### `architecture-review` - Architecture Review\n**Arguments:**\n- `architecture_type` (required): Type of architecture (microservices, monolithic, serverless, hybrid)\n- `review_focus` (optional): Primary focus area (scalability, security, maintainability, performance)\n\nArchitectural assessment framework with design pattern analysis, technology stack evaluation, and improvement recommendations.\n\n#### Knowledge \u0026 Team Management\n#### `knowledge-transfer` - Knowledge Transfer\n**Arguments:**\n- `knowledge_domain` (required): Domain of knowledge (technical, process, business)\n- `transfer_recipients` (optional): Who needs to receive the knowledge (team, individual, department)\n\nKnowledge transfer planning and execution with session management, documentation, and effectiveness validation.\n\n#### `vendor-management` - Vendor Management\n**Arguments:**\n- `vendor_type` (required): Type of vendor service (cloud, development, consulting, infrastructure)\n- `contract_value` (optional): Contract value range (small, medium, large, enterprise)\n\nVendor relationship management including contract tracking, performance monitoring, and cost optimization.\n\n#### Incident \u0026 Crisis Management\n#### `incident-response` - Incident Response\n**Arguments:**\n- `incident_severity` (required): Severity level (critical, high, medium, low)\n- `incident_type` (optional): Type of incident (security, performance, functionality, availability)\n\nIncident response framework with containment, recovery, root cause analysis, and post-incident review.\n\n#### Financial \u0026 Resource Management\n#### `cost-management` - Cost Management\n**Arguments:**\n- `cost_category` (required): Primary cost category (infrastructure, personnel, tools, licenses)\n- `budget_constraint` (optional): Budget constraint level (strict, flexible, unlimited)\n\nCost monitoring, optimization strategies, and budget management with forecasting and reporting.\n\n#### Customer \u0026 Innovation Management\n#### `customer-feedback` - Customer Feedback Management\n**Arguments:**\n- `feedback_channel` (required): Primary feedback channel (survey, support, reviews, analytics)\n- `feedback_focus` (optional): Focus area (usability, features, performance, support)\n\nCustomer feedback collection, analysis, and action planning with continuous improvement cycles.\n\n#### `innovation-planning` - Innovation Planning\n**Arguments:**\n- `innovation_type` (required): Type of innovation (product, process, technology, business_model)\n- `risk_tolerance` (optional): Risk tolerance level (conservative, moderate, aggressive)\n\nInnovation management framework with idea generation, experimentation, and success measurement.\n\n### How AI Models Use Guidance\n\n1. **Discovery**: List available resources and prompts to understand capabilities\n2. **Learning**: Read relevant resources to understand project management concepts\n3. **Planning**: Use appropriate prompts for complex workflows\n4. **Execution**: Follow structured guidance to use tools effectively\n5. **Verification**: Check results and iterate as needed\nThis guidance system ensures AI models can provide expert-level project management assistance using the Project Guardian toolset.\n\n### Behavioral Protocol (System Rules)\n\nEvery `prompts/get` response from this MCP server includes a shared **Behavioral Protocol** as a system message (implemented in `src/prompts/behavioral-protocol.ts`). This protocol enforces:\n\n- Minimal, production-ready, self-documenting code with a security-first approach.\n- No buzzwords, unnecessary emoji, or filler; direct, technically accurate answers.\n- Adaptive response depth based on the user's request (quick answers vs. complex breakdowns).\n- Consistent use of validated best practices for systems, programming, UI/UX, and design.\n\nClients integrating this MCP server should treat the first system message as the governing rules for any downstream model that uses these prompts.\n\n## Usage Examples\n\n### Project Guardian Setup\n\n```typescript\n// Initialize the project memory system\nconst initResult = await mcpClient.callTool('initialize_memory', {});\n\n// Create your first project entities\nconst entityResult = await mcpClient.callTool('create_entity', {\n  entities: [\n    {\n      name: 'web_platform',\n      entityType: 'project',\n      observations: ['Main web application platform', 'React + Node.js stack', 'Q2 2024 delivery']\n    },\n    {\n      name: 'user_authentication',\n      entityType: 'feature',\n      observations: ['OAuth2 implementation', 'Google/GitHub providers', 'JWT tokens']\n    }\n  ]\n});\n\n// Establish project relationships\nconst relationResult = await mcpClient.callTool('create_relation', {\n  relations: [\n    {\n      from: 'user_authentication',\n      to: 'web_platform',\n      relationType: 'part_of'\n    }\n  ]\n});\n```\n\n### Project Management Workflow\n\n```typescript\n// Add progress observations\nawait mcpClient.callTool('add_observation', {\n  observations: [\n    {\n      entityName: 'user_authentication',\n      contents: [\n        'Completed OAuth2 setup for Google provider',\n        'JWT implementation finished',\n        'Unit tests passing at 95% coverage'\n      ]\n    }\n  ]\n});\n\n// Search project knowledge\nconst searchResult = await mcpClient.callTool('search_nodes', {\n  query: 'authentication'\n});\n\n// Read entire project knowledge graph\nconst graphResult = await mcpClient.callTool('read_graph', {});\n\n// Get detailed entity information\nconst entityDetails = await mcpClient.callTool('open_node', {\n  names: ['user_authentication', 'web_platform']\n});\n```\n\n### Database Operations\n\n```typescript\n// Execute custom SQL queries\nconst sqlResult = await mcpClient.callTool('execute_sql', {\n  query: 'SELECT * FROM entities WHERE entity_type = ?',\n  parameters: ['project']\n});\n\n// Query project data\nconst queryResult = await mcpClient.callTool('query_data', {\n  table: 'entities',\n  conditions: { entity_type: 'task' },\n  limit: 10\n});\n\n// Import/export data\nconst importResult = await mcpClient.callTool('import_data', {\n  table: 'project_data',\n  filePath: './project_backup.csv',\n  format: 'csv'\n});\n```\n\n## Configuration\n\n### For Cursor IDE\n\nAdd this server to your Cursor MCP configuration (`~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"project-guardian\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/project-guardian-mcp-server/dist/index.js\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### For Claude Desktop\n\nAdd this server to your Claude Desktop configuration (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"project-guardian\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/project-guardian-mcp-server/dist/index.js\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n## Project Structure\n\n```\nproject-guardian-mcp-server/\n├── src/\n│   ├── index.ts              # Main entry point\n│   ├── server.ts             # MCP server orchestrator (161 lines, fully modularized)\n│   ├── memory-manager.ts     # Knowledge graph and entity management\n│   ├── sqlite-manager.ts     # Database operations and connection management\n│   ├── import-export.ts      # CSV/JSON data import and export functionality\n│   ├── types.ts              # TypeScript type definitions and schemas\n│   ├── handlers/\n│   │   └── request-handlers.ts # Central tool execution dispatcher\n│   ├── tools/\n│   │   ├── tool-registry.ts     # Tool definitions and listing\n│   │   ├── database-tools.ts    # Database operation tool schemas\n│   │   └── memory-tools.ts      # Memory management tool schemas\n│   ├── resources/\n│   │   ├── resource-registry.ts  # Resource definitions and handlers\n│   │   ├── resource-definitions.ts # Static resource metadata\n│   │   └── resource-handlers.ts   # Dynamic resource content generation\n│   └── prompts/\n│       ├── prompt-registry.ts       # Prompt definitions and handlers\n│       ├── prompt-definitions.ts    # Static prompt metadata\n│       ├── prompt-handlers.ts       # Dynamic prompt content generation\n│       └── behavioral-protocol.ts   # Shared Behavioral Protocol system prompt\n├── __tests__/                # Comprehensive test suite\n│   ├── tool-registry.test.ts\n│   ├── resource-registry.test.ts\n│   ├── prompt-registry.test.ts\n│   ├── request-handlers.test.ts\n│   ├── import-export.test.ts\n│   └── sqlite-manager.test.ts\n├── dist/                     # Compiled JavaScript output (optimized for production)\n├── memory.db                 # SQLite database file (created on first run)\n├── package.json              # Project dependencies and scripts\n├── package.prod.json         # Production-only dependencies for smaller bundle\n├── tsconfig.json            # TypeScript configuration\n├── jest.config.js           # Test configuration\n└── README.md                # This documentation\n```\n\n### Key Components\n\n- **server.ts**: Clean orchestrator (161 lines) coordinating modular components\n- **handlers/request-handlers.ts**: Central dispatcher routing tool calls to appropriate managers\n- **tools/**: Tool definition and registration system (17 tools total)\n  - `tool-registry.ts`: Lists all available tools\n  - `database-tools.ts`: Database operation schemas (7 tools)\n  - `memory-tools.ts`: Memory management schemas (10 tools)\n- **resources/**: Resource management system (11 resources total)\n  - `resource-registry.ts`: Resource listing and content serving\n  - `resource-definitions.ts`: Static resource metadata\n  - `resource-handlers.ts`: Dynamic content generation\n- **prompts/**: Prompt management system (28 prompts total)\n  - `prompt-registry.ts`: Prompt listing and content serving\n  - `prompt-definitions.ts`: Static prompt metadata\n  - `prompt-handlers.ts`: Dynamic prompt generation with context\n  - `behavioral-protocol.ts`: Centralized Behavioral Protocol system message used by all prompts\n- **memory-manager.ts**: Knowledge graph operations for entities, relationships, and observations\n- **sqlite-manager.ts**: Database abstraction layer with connection pooling and schema management\n- **import-export.ts**: Data transfer utilities for CSV and JSON formats\n- **types.ts**: Zod schemas for input validation and TypeScript type safety\n\n## Development\n\n1. **Clone the repository:**\n```bash\ngit clone https://github.com/1999AZZAR/project-guardian-mcp-server.git\ncd project-guardian-mcp-server\n```\n\n2. **Install dependencies:**\n```bash\nnpm install\n```\n\n3. **Build the project:**\n```bash\nnpm run build\n```\n\n4. **Test the server:**\n```bash\nnpm start\n```\n\n## License\n\nMIT License - see LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Fproject-guardian-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1999azzar%2Fproject-guardian-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Fproject-guardian-mcp-server/lists"}