shouldideploy-today-mcp-server 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leonardo Camargo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+shouldideploy-today-mcp-server
+================================
+
+Simple MCP server that calls the public [`shouldideploy.today`](https://shouldideploy.today/) API to answer whether it is a good idea to deploy today.
+
+### Requirements
+
+- **Node.js** 18+ (20+ recommended)
+- **npm** 9+
+
+### Installation
+
+In the project directory:
+
+```bash
+npm install
+```
+
+### How to run the MCP server
+
+```bash
+npm start
+```
+
+The server uses **stdio** as the transport (MCP default). Typically you do not call it directly; instead, you register it in an MCP client (such as Cursor, Claude Desktop, etc.).
+
+### Available tool
+
+- **Name**: `shouldideploy_today`  
+  - **Description**: Calls the `shouldideploy.today` API to check if it is a good idea to deploy today.
+  - **Input (JSON)**:
+    - `tz` *(string, optional)*: IANA timezone, for example `America/Sao_Paulo` or `UTC`. Default: `UTC`.
+    - `lang` *(string, optional)*: response language, for example `en`. Default: `en`.
+  - **Output**: plain text returned by the API, for example something like “Yes, you should deploy today” or “No, you should not deploy today”.
+
+### How it works
+
+- The server is implemented in `index.ts` using `@modelcontextprotocol/sdk`:
+  - Creates an `McpServer` named `shouldideploy-today-mcp-server`.
+  - Exposes the `shouldideploy_today` tool.
+  - Builds the API URL using `URL` and `searchParams`:
+    - Base: `https://shouldideploy.today/api`
+    - Query params: `tz` and `lang`
+  - Performs an HTTP `fetch`, reads the body as text and returns it as the MCP response.
+
+### License
+
+This project is distributed under the MIT license. See `LICENSE` for more details.

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+export type APIParams = {
+    tz?: string;
+    lang?: string;
+};
+export type APIResponse = {
+    timezone: string;
+    date: string;
+    shouldideploy: boolean;
+    message: string;
+};
+export declare function makeRequest({ tz, lang }: APIParams): Promise<APIResponse | null>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAA;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAU,EAAE,IAAW,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiBrG"}

package/dist/client.js

@@ -0,0 +1,14 @@
+export async function makeRequest({ tz = 'UTC', lang = 'en' }) {
+    const url = new URL("https://shouldideploy.today/api");
+    url.searchParams.set("tz", tz);
+    url.searchParams.set("lang", lang);
+    try {
+        const response = await fetch(url.toString());
+        if (response.ok)
+            return await response.json();
+        return null;
+    }
+    catch (err) {
+        throw new Error(err.message);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { makeRequest } from './client.js';
+const server = new McpServer({
+    name: 'shouldideploy-today-mcp-server',
+    version: '1.0.0',
+});
+server.registerTool('shouldideploy_today', {
+    description: 'Returns a FINAL, short and funny message to the user about whether they should deploy right now. The model MUST respond ONLY with the returned text, with no extra words or formatting.',
+    inputSchema: {
+        tz: z.string().optional().describe('IANA timezone (e.g., America/Sao_Paulo, UTC). If omitted, UTC is used.'),
+        lang: z.string().optional().describe('Response language (e.g., en, el). If omitted, en is used.'),
+    }
+}, async (params) => {
+    const result = await makeRequest(params);
+    if (!result) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Failed to retrieve alerts data',
+                    isError: true,
+                },
+            ],
+        };
+    }
+    const text = formatResult(result);
+    return {
+        content: [
+            { type: 'text', text }
+        ]
+    };
+});
+function formatResult(apiResponse) {
+    return apiResponse.message;
+}
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Should I Deploy Today MCP Server running on stdio');
+}
+main().catch((err) => {
+    console.error('Error starting MCP server:', err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "shouldideploy-today-mcp-server",
+  "version": "0.3.0",
+  "description": "Simple MCP server that calls the shouldideploy.today API to tell you whether you should deploy today.",
+  "bin": {
+    "shouldideploy-today-mcp-server": "./dist/index.js"
+  },
+  "keywords": [
+    "mcp-server",
+    "shouldideploytoday"
+  ],
+  "homepage": "https://github.com/leonardorcamargo/shouldideploy-today-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/leonardorcamargo/shouldideploy-today-mcp-server/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leonardorcamargo/shouldideploy-today-mcp-server.git"
+  },
+  "license": "MIT",
+  "author": "Leonardo Camargo",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && chmod 755 dist/index.js",
+    "start": "npm run build && node dist/index.js",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "prepublishOnly": "npm test && npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.9",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.2"
+  }
+}