{"_id":"@temps-sdk/mcp","_rev":"4-4a853d1810067b8fe49ebdb8b430ab57","name":"@temps-sdk/mcp","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@temps-sdk/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","temps","ai","deployment","devops"],"author":"","license":"MIT","_id":"@temps-sdk/mcp@0.1.0","maintainers":[{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"}],"bin":{"mcp":"dist/index.js"},"dist":{"shasum":"e79d4901d67c1b2ee567a17a6b07c28a18371588","tarball":"https://registry.npmjs.org/@temps-sdk/mcp/-/mcp-0.1.0.tgz","fileCount":236,"integrity":"sha512-BvLo73c8GDUYVgUYAnoLenB9urh/d2YrWBj8y+k0AmXQti/KA2hB+aqgwdjkC7RbiMllmW+H5K82TVXIVIKSvg==","signatures":[{"sig":"MEYCIQD1Aaiab5AUVylB29cxO5J+d+VGOsaph4WMXsaudi4ZAAIhAIwXk2/hh+x5wXGE8f5xArKk64euhCqnOSm+DG3r7Jms","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1981797},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"34d29712641cebf562926d26ccf5447f4e2be886","scripts":{"dev":"tsx watch src/index.ts","test":"tsx src/test/integration.ts","build":"tsc && cp -r src/prompts/templates dist/prompts/","start":"node dist/index.js","test:group":"tsx src/test/integration.ts --group","type-check":"tsc --noEmit","generate:api":"bun openapi-ts","prepublishOnly":"bun run build"},"_npmUser":{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"},"_npmVersion":"11.6.0","description":"Temps MCP Server - Model Context Protocol integration for the Temps deployment platform","directories":{},"_nodeVersion":"24.9.0","dependencies":{"@hey-api/client-fetch":"^0.13.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.3","@types/node":"^22.10.5","@hey-api/openapi-ts":"^0.88.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1771401351778_0.7295599103221191","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@temps-sdk/mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","temps","ai","deployment","devops"],"author":"","license":"MIT","_id":"@temps-sdk/mcp@0.1.1","maintainers":[{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"}],"bin":{"mcp":"dist/index.js"},"dist":{"shasum":"2d7f5ec4a4429080b9dd07105065db86eab17f76","tarball":"https://registry.npmjs.org/@temps-sdk/mcp/-/mcp-0.1.1.tgz","fileCount":236,"integrity":"sha512-8RykypMUmkPbwGopMsIlwbmcGad8vxFbZf72v3ooI19pzOpMEuJwLlGQKskIKpzbTOsc+SOrFCTrpCRq8nzfHA==","signatures":[{"sig":"MEQCIGnRaXYn+JpsuPs3LURc6JeYhLUVMJ28bNnmAz3cmJmIAiBII1G+m9sb94i4q0oEW1xIVryQQVbGzBC4IQre9+oz3A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1992302},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"34d29712641cebf562926d26ccf5447f4e2be886","scripts":{"dev":"tsx watch src/index.ts","test":"tsx src/test/integration.ts","build":"tsc && cp -r src/prompts/templates dist/prompts/","start":"node dist/index.js","test:group":"tsx src/test/integration.ts --group","type-check":"tsc --noEmit","generate:api":"bun openapi-ts","prepublishOnly":"bun run build"},"_npmUser":{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"},"_npmVersion":"11.6.0","description":"Temps MCP Server - Model Context Protocol integration for the Temps deployment platform","directories":{},"_nodeVersion":"24.9.0","dependencies":{"@hey-api/client-fetch":"^0.13.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.3","@types/node":"^22.10.5","@hey-api/openapi-ts":"^0.88.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1771405979652_0.6601231999334047","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@temps-sdk/mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","temps","ai","deployment","devops"],"author":"","license":"MIT","_id":"@temps-sdk/mcp@0.1.2","maintainers":[{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"}],"bin":{"mcp":"dist/index.js"},"dist":{"shasum":"b26c6f9b0b8eee675032f5b9a9ab10702fe651be","tarball":"https://registry.npmjs.org/@temps-sdk/mcp/-/mcp-0.1.2.tgz","fileCount":240,"integrity":"sha512-5DLx3uEH0dxfQSfUCu76kibnz6XZsulwWrfxoh6E+7AjbabZnQWwx/K9vQfQ/GhKLIDBHIe2TSbwUy51XzyaNQ==","signatures":[{"sig":"MEQCIDw1DYGkrVH1eL0ikwJWWNowPVdcHW2tFT39pS1BvcwZAiABHW62H3gvSZ1Cw+6Fi4p326kJjTKY6wX1maCHKrhbMQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2048599},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"3b61cd485fad9d1d529715ad746111eb6670614c","scripts":{"dev":"tsx watch src/index.ts","test":"tsx src/test/integration.ts","build":"tsc && cp -r src/prompts/templates dist/prompts/","start":"node dist/index.js","test:group":"tsx src/test/integration.ts --group","type-check":"tsc --noEmit","generate:api":"bun openapi-ts","prepublishOnly":"bun run build"},"_npmUser":{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"},"_npmVersion":"11.6.0","description":"Temps MCP Server - Model Context Protocol integration for the Temps deployment platform","directories":{},"_nodeVersion":"24.9.0","dependencies":{"@hey-api/client-fetch":"^0.13.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.3","@types/node":"^22.10.5","@hey-api/openapi-ts":"^0.88.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1771416004353_0.5743566823447441","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@temps-sdk/mcp","version":"0.1.3","description":"Temps MCP Server - Model Context Protocol integration for the Temps deployment platform","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"mcp":"dist/index.js"},"scripts":{"build":"tsc && cp -r src/prompts/templates dist/prompts/","dev":"tsx watch src/index.ts","start":"node dist/index.js","test":"tsx src/test/integration.ts","test:group":"tsx src/test/integration.ts --group","generate:api":"bun openapi-ts","type-check":"tsc --noEmit","prepublishOnly":"bun run build"},"keywords":["mcp","model-context-protocol","temps","ai","deployment","devops"],"author":"","license":"MIT","dependencies":{"@hey-api/client-fetch":"^0.13.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@hey-api/openapi-ts":"^0.88.0","@types/node":"^22.10.5","tsx":"^4.19.2","typescript":"^5.7.3"},"_id":"@temps-sdk/mcp@0.1.3","gitHead":"3b61cd485fad9d1d529715ad746111eb6670614c","_nodeVersion":"24.9.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-uSH7AL65211TI6CRXFq3m+AO3N/uHuxBcWEgOBZJYBJBD0afgrkWcGUFNE097WhiDUqnpj4GR4hKBM7hqslGKw==","shasum":"8aec1e8a5b1de4d3139e5903dd6e5a3b67a45955","tarball":"https://registry.npmjs.org/@temps-sdk/mcp/-/mcp-0.1.3.tgz","fileCount":240,"unpackedSize":2080801,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCKom9z6cfAtLBH8E/uspWyvL2nt6P/XMQ1u+6VpQlG3QIgd7aMgvz5D0uXXKzwFH89tFSOlLI18Iecx20vdid0VEE="}]},"_npmUser":{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"},"directories":{},"maintainers":[{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.3_1771418249503_0.25731408396189437"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-18T07:55:51.646Z","modified":"2026-02-18T12:37:29.864Z","0.1.0":"2026-02-18T07:55:51.938Z","0.1.1":"2026-02-18T09:12:59.849Z","0.1.2":"2026-02-18T12:00:04.530Z","0.1.3":"2026-02-18T12:37:29.707Z"},"license":"MIT","keywords":["mcp","model-context-protocol","temps","ai","deployment","devops"],"description":"Temps MCP Server - Model Context Protocol integration for the Temps deployment platform","maintainers":[{"name":"dviejokfs","email":"dviejo@kungfusoftware.es"}],"readme":"# Temps MCP Server\n\nModel Context Protocol (MCP) server for the Temps platform. Provides AI assistants with reusable prompts to interact with Temps projects, deployments, and infrastructure.\n\n## Features\n\n- **Prompts**: Reusable prompt templates for common Temps operations\n  - `add_react_analytics` - Step-by-step guide to add analytics to React apps\n\n## Installation\n\n```bash\n# Install dependencies\nbun install\n\n# Build the server\nbun run build\n```\n\n## Quick Start\n\n### Test with MCP Inspector (Recommended)\n\n```bash\n# Install MCP Inspector globally\nnpm install -g @modelcontextprotocol/inspector\n\n# Run the inspector\nmcp-inspector node dist/index.js\n```\n\nThis opens a web interface where you can test all prompts interactively.\n\n### Use with Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n**macOS/Linux**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"temps\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/temps/mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop to activate the server.\n\n## Project Structure\n\n```\nmcp/\n├── src/\n│   ├── index.ts              # Main server entry point\n│   ├── types/                # Shared type definitions\n│   │   └── index.ts          # Prompt types\n│   ├── handlers/             # Request handlers\n│   │   ├── index.ts          # Handler exports\n│   │   └── prompts-handler.ts    # Prompt request handling\n│   └── prompts/              # Prompt implementations (one per file)\n│       ├── index.ts              # Prompts registry\n│       └── add-react-analytics.ts # React analytics setup guide\n├── dist/                     # Compiled JavaScript output\n├── package.json\n├── tsconfig.json\n├── TESTING.md               # Detailed testing guide\n└── README.md                # This file\n```\n\n## Development\n\n### Watch Mode\n\nAuto-rebuild on file changes:\n\n```bash\nbun run dev\n```\n\n### Type Checking\n\n```bash\nbun run type-check\n```\n\n### Building\n\n```bash\nbun run build\n```\n\n## Adding a New Prompt\n\n1. Create `src/prompts/my-prompt.ts`:\n\n```typescript\nimport { PromptDefinition } from '../types/index.js';\n\nexport const myPrompt: PromptDefinition = {\n  name: 'my_prompt',\n  description: 'Description of this prompt',\n  arguments: [\n    {\n      name: 'param1',\n      description: 'First parameter',\n      required: true,\n    },\n  ],\n  handler: async (args) => {\n    const param1 = args.param1 as string;\n\n    return {\n      messages: [\n        {\n          role: 'user',\n          content: {\n            type: 'text',\n            text: `User message with ${param1}`,\n          },\n        },\n        {\n          role: 'assistant',\n          content: {\n            type: 'text',\n            text: 'Assistant response',\n          },\n        },\n      ],\n    };\n  },\n};\n```\n\n2. Export from `src/prompts/index.ts`:\n\n```typescript\nimport { myPrompt } from './my-prompt.js';\n\nexport const prompts = [\n  // ... existing prompts\n  myPrompt,\n];\n```\n\n3. Rebuild and test:\n\n```bash\nbun run build\nmcp-inspector node dist/index.js\n```\n\n## Architecture\n\nThe server follows a modular architecture:\n\n- **Types**: Shared TypeScript interfaces for prompts\n- **Handlers**: Handle MCP protocol requests and delegate to prompt implementations\n- **Prompts**: Individual prompt implementations in separate files for maintainability\n\nThis structure makes it easy to:\n- Add new prompts without modifying existing code\n- Test individual prompts in isolation\n- Understand the codebase at a glance\n- Scale to dozens of prompts\n\n## Testing\n\nSee [TESTING.md](./TESTING.md) for comprehensive testing instructions.\n\nQuick test:\n\n```bash\n# Using MCP Inspector\nmcp-inspector node dist/index.js\n\n# Or run the test script\n./test-local.sh\n```\n\n## Available Prompts\n\n### add_react_analytics\n\nComprehensive guide to add Temps analytics to a React application with step-by-step instructions for different frameworks.\n\n**Arguments:**\n- `framework` (string, required): The React framework being used\n  - `nextjs-app` - Next.js App Router (13+)\n  - `nextjs-pages` - Next.js Pages Router\n  - `vite` - Vite + React\n  - `cra` - Create React App\n  - `remix` - Remix Framework\n- `project_id` (number, optional): The Temps project ID for analytics\n\n**Features Included:**\n- Installation and basic setup\n- Provider configuration\n- Custom event tracking (`useTrackEvent`)\n- Scroll visibility tracking (`useScrollVisibility`)\n- Page leave tracking with time on page (`usePageLeave`)\n- User engagement tracking with heartbeat system (`useEngagementTracking`)\n- Session recording with privacy controls (`useSessionRecording`)\n- Performance tracking with Web Vitals (`useSpeedAnalytics`)\n- Manual pageview tracking (`useTrackPageview`)\n- User identification\n- Advanced provider configuration\n- Comprehensive troubleshooting guide\n\n**Usage:**\n```json\n{\n  \"name\": \"add_react_analytics\",\n  \"arguments\": {\n    \"framework\": \"nextjs-app\",\n    \"project_id\": 1\n  }\n}\n```\n\n**Example Response Includes:**\n- Framework-specific installation steps\n- Provider setup with configuration options\n- Code examples for all tracking hooks\n- Privacy and performance considerations\n- Debug mode and troubleshooting tips\n\n## Next Steps\n\n- [ ] Connect to actual Temps API for real data\n- [ ] Add authentication/authorization\n- [ ] Create more useful prompts (debugging, optimization, troubleshooting)\n- [ ] Add error handling and retries\n- [ ] Write unit tests\n- [ ] Publish to npm\n\n## Resources\n\n- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)\n- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n- [MCP Servers Examples](https://github.com/modelcontextprotocol/servers)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}