MCP Cognitive Tools Server

A Model Context Protocol (MCP) server that provides cognitive tools for thought processes, goal tracking, and dynamic skill creation.

• Fork Thought: Perform parallel explorations of ideas before merging insights
• Goal Tracking: Create, update, and monitor goals with hierarchical structure
• Task Management: Break down goals into actionable tasks with state tracking
• State Management: Track and persist cognitive states across sessions

• Skill Creation: Write and store reusable scripts as "skills"
• Skill Execution: Dynamically invoke created skills as tools
• Skill Management: List, update, and delete skills

• Header-based authentication using environment variable
• Secure skill execution with sandboxing

├── backend/
│   ├── database/
│   │   ├── migrations.ts    # Database schema
│   │   └── queries.ts       # Database operations
│   ├── mcp/
│   │   ├── server.ts        # MCP server implementation
│   │   ├── tools/           # Core cognitive tools
│   │   │   ├── fork-thought.ts
│   │   │   ├── goals.ts
│   │   │   ├── tasks.ts
│   │   │   ├── states.ts
│   │   │   └── skills.ts
│   │   └── auth.ts          # Authentication middleware
│   └── index.ts             # Main entry point
├── shared/
│   └── types.ts             # Shared TypeScript types
└── README.md

• MCP_AUTH_TOKEN: Required authentication token for API access

• POST /mcp - Main MCP protocol endpoint
• GET /health - Health check endpoint

The server implements the MCP protocol and provides tools for:

1. Thought Management: Fork, explore, and merge thought processes
2. Goal Setting: Create hierarchical goals with progress tracking
3. Task Execution: Break down goals into manageable tasks
4. State Persistence: Save and restore cognitive states
5. Skill Development: Create custom tools dynamically

All requests must include the Authorization header with the value from MCP_AUTH_TOKEN environment variable.