DillyDallyMCP

# DillyDallyMCP A Model Context Protocol (MCP) server ready for Dedalus deployment. ## Setup ### 1. Initialize Git Repository ```bash cd dedalus-mcp git init git add . git commit -m "Initial commit: Dedalus MCP server" ``` ### 2. Create Remote Repository Create a new repository on GitHub/GitLab/etc. named `DillyDallyMCP`, then: ```bash git remote add origin <your-repo-url> git branch -M main git push -u origin main ``` ### 3. Configure Environment Variables Create a `.env.local` file in the `dedalus-mcp` folder: ```bash CONVEX_URL=https://your-deployment.convex.cloud ``` You can find your Convex URL in: - The monorepo root `.env.local` file (if running locally) - Your Convex dashboard - By running `npx convex dev` from the monorepo root **Note:** The `.env.local` file is gitignored and should not be committed. ### 4. Install Dependencies ```bash npm install ``` ### 5. Build ```bash npm run build ``` ## Testing Locally ### STDIO Mode (for MCP clients) ```bash npm run dev:stdio ``` ### HTTP Mode (for testing/debugging) ```bash npm run dev:http ``` The server will start on `http://localhost:3002` ### Using MCP Inspector ```bash npm run build npm run inspector ``` ## Deployment to Dedalus This server follows Dedalus deployment standards: - ✅ Entry point: `src/index.ts` (or `index.ts` at root) - ✅ TypeScript server structure - ✅ Proper package.json configuration Simply connect your repository to Dedalus and it will automatically detect and deploy the MCP server. ## Project Structure ``` dedalus-mcp/ ├── index.ts # Main entry point ├── server.ts # MCP server implementation ├── cli.ts # CLI argument parsing ├── lib/ # Shared utilities │ └── convexClient.ts # Convex client setup ├── tools/ # MCP tools │ ├── index.ts │ ├── addIntegers.ts │ ├── getRecentActivity.ts │ ├── getLastSession.ts │ ├── getProductivityStats.ts │ ├── getSessionDetails.ts │ └── getAttentionMetrics.ts ├── transport/ # Transport implementations │ ├── index.ts │ ├── http.ts │ └── stdio.ts ├── package.json ├── tsconfig.json └── .env.local # Environment variables (create this) ``` ## Available Tools - `add_integers`: Adds two integers together - `get_recent_activity`: Get recent activity snapshots from DillyDally - `get_last_session`: Get details of the most recent DillyDally session - `get_productivity_stats`: Get productivity statistics over a time range - `get_session_details`: Get detailed information about a specific session - `get_attention_metrics`: Get attention/focus metrics from camera snapshots ## License MIT