MCP Session Closer

# MCP Session Closer A Model Context Protocol (MCP) server for Cursor that gracefully closes work sessions, syncs context files, updates Agent OS files, and commits changes to git. ## Features * **end_session**: Close Cursor sessions with automatic context sync and git commit * **sync_context_files**: Sync context files across `claude.md`, `gemini.md`, `agents.md`, and `.cursor/context.md` * **update_session_summary**: Update session summaries without closing the session ## Quick Setup ### 1. Install Dependencies ```bash npm install ``` ### 2. Build the Server ```bash npm run build ``` ### 3. Configure Cursor Add to your Cursor MCP settings (`~/.cursor/mcp.json` or `%APPDATA%\Cursor\mcp.json` on Windows): ```json { "mcpServers": { "session-closer": { "command": "node", "args": [ "/path/to/mcp-session-closer/dist/index.js" ], "env": { "CURSOR_WORKSPACE": "${workspaceFolder}" } } } } ``` **Note**: Replace `/path/to/mcp-session-closer` with your actual path. On Windows, use forward slashes or double backslashes. ### 4. Restart Cursor Restart Cursor to load the MCP server. ## Usage ### End Session In Cursor chat, simply ask: ``` Close this session and sync everything ``` Or use the tool directly: ``` Use end_session with conversationSummary: "Implemented user auth, fixed login bugs" ``` The server will: 1. Extract session details (accomplishments, decisions, blockers, next steps) 2. Update `.agent-os/session-summary.md` 3. Update Agent OS roadmap and decisions (if present) 4. Sync all context files (`claude.md`, `gemini.md`, `agents.md`, `.cursor/context.md`) 5. Commit all changes to git with descriptive message ### Sync Context Files Only ``` Sync context files ``` Or: ``` Use sync_context_files ``` ### Update Session Summary Only ``` Use update_session_summary with summary: "Made progress on feature X" ``` ## How It Works ### Session Closing Flow When you call `end_session`, the server automatically: 1. **Gathers Session Info** - Extracts accomplishments from conversation - Identifies decisions made - Notes any blockers - Lists next steps - Tracks changed files 2. **Updates Session Summary** - Creates/updates `.agent-os/session-summary.md` - Appends session details with timestamp - Formats as structured markdown 3. **Updates Agent OS** (if present) - Marks completed items in `.agent-os/product/roadmap.md` - Adds new decisions to `.agent-os/product/decisions.md` - Maintains proper markdown structure 4. **Syncs Context Files** - Reads content from all context files - Merges and deduplicates content - Updates all files with unified context: - `claude.md` - `gemini.md` - `agents.md` - `.cursor/context.md` 5. **Commits to Git** - Stages all modified files - Creates descriptive commit message - Commits with timestamp ## Configuration ### Required Environment Variables * `CURSOR_WORKSPACE` - Set automatically by Cursor to the current workspace folder ### Optional Files The server works with or without these files: * `.agent-os/session-summary.md` - Session history (created if missing) * `.agent-os/product/roadmap.md` - Product roadmap (updated if present) * `.agent-os/product/decisions.md` - Decision log (updated if present) * `claude.md`, `gemini.md`, `agents.md`, `.cursor/context.md` - Context files ## Development ### Run in Development Mode ```bash npm run dev ``` ### Build ```bash npm run build ``` ### Start Production Server ```bash npm start ``` ## Troubleshooting ### MCP Server Not Found * Verify the path in Cursor MCP config is correct * Use forward slashes or escaped backslashes on Windows * Check that `dist/index.js` exists after building ### Git Commit Fails * Ensure git is initialized: `git init` * Configure git user: ```bash git config user.name "Your Name" git config user.email "your.email@example.com" ``` * Check you have write permissions ### Context Files Not Syncing * Verify write permissions in the workspace directory * Check that no other processes are locking the files * Ensure the workspace path is correct ### Session Summary Not Updating * Check that `.agent-os` directory exists (created automatically) * Verify write permissions in the workspace * Look for errors in Cursor's MCP logs ## Project Structure ``` mcp-session-closer/ ├── src/ │ ├── index.ts # MCP server implementation │ ├── session-closer.ts # Core session closing logic │ └── types.ts # TypeScript type definitions ├── dist/ # Compiled JavaScript (generated) ├── package.json # Node.js dependencies ├── tsconfig.json # TypeScript configuration └── README.md # This file ``` ## Why Use This? ### Automated Workflow * **No Manual Steps**: Automatically syncs, updates, and commits * **Consistent Format**: Standardized session summaries and git commits * **Time Saver**: Closes sessions in seconds, not minutes ### Context Continuity * **Unified Context**: All AI assistants see the same project context * **Cross-Session Memory**: Session summaries persist across restarts * **Decision Tracking**: Maintains history of why decisions were made ### Git Integration * **Automatic Commits**: Never forget to commit your work * **Descriptive Messages**: Auto-generated commit messages with context * **Clean History**: Organized commits at natural breakpoints ## License MIT ## Contributing This is a personal tool, but feel free to fork and adapt it for your needs!