@aashari/boilerplate-mcp-server 1.0.0

package/.eslintrc.json

@@ -0,0 +1,19 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint", "prettier"],
+  "extends": [
+    "eslint:recommended", 
+    "plugin:@typescript-eslint/recommended", 
+    "prettier"
+  ],
+  "rules": {
+    "prettier/prettier": ["error"],
+    "indent": ["error", "tab", { "SwitchCase": 1 }],
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
+  },
+  "env": {
+    "node": true,
+    "jest": true
+  },
+  "ignorePatterns": ["node_modules/**", "dist/**", "examples/**"]
+} 

package/.node-version

@@ -0,0 +1 @@
+22.14.0

package/.releaserc.json

@@ -0,0 +1,34 @@
+{
+	"branches": ["main"],
+	"plugins": [
+		"@semantic-release/commit-analyzer",
+		"@semantic-release/release-notes-generator",
+		"@semantic-release/changelog",
+		[
+			"@semantic-release/exec",
+			{
+				"prepareCmd": "node scripts/update-version.js ${nextRelease.version} && npm run build"
+			}
+		],
+		[
+			"@semantic-release/npm",
+			{
+				"npmPublish": true,
+				"pkgRoot": "."
+			}
+		],
+		[
+			"@semantic-release/git",
+			{
+				"assets": [
+					"package.json",
+					"CHANGELOG.md",
+					"src/index.ts",
+					"dist/index.js"
+				],
+				"message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+			}
+		],
+		"@semantic-release/github"
+	]
+}

package/CHANGELOG.md

@@ -0,0 +1,107 @@
+# 1.0.0 (2025-03-22)
+
+
+### Bug Fixes
+
+* add workflows permission to semantic-release workflow ([de3a335](https://github.com/aashari/boilerplate-mcp-server/commit/de3a33510bd447af353444db1fcb58e1b1aa02e4))
+* improve GitHub Packages publishing with a more robust approach ([fd2aec9](https://github.com/aashari/boilerplate-mcp-server/commit/fd2aec9926cf99d301cbb2b5f5ca961a6b6fec7e))
+* improve GitHub Packages publishing with better error handling and debugging ([db25f04](https://github.com/aashari/boilerplate-mcp-server/commit/db25f04925e884349fcf3ab85316550fde231d1f))
+* improve GITHUB_OUTPUT syntax in semantic-release workflow ([6f154bc](https://github.com/aashari/boilerplate-mcp-server/commit/6f154bc43f42475857e9256b0a671c3263dc9708))
+* improve version detection for global installations ([97a95dc](https://github.com/aashari/boilerplate-mcp-server/commit/97a95dca61d8cd7a86c81bde4cb38c509b810dc0))
+* make publish workflow more resilient against version conflicts ([ffd3705](https://github.com/aashari/boilerplate-mcp-server/commit/ffd3705bc064ee9135402052a0dc7fe32645714b))
+* remove invalid workflows permission ([c012e46](https://github.com/aashari/boilerplate-mcp-server/commit/c012e46a29070c8394f7ab596fe7ba68c037d3a3))
+* remove type module to fix CommonJS compatibility ([8b1f00c](https://github.com/aashari/boilerplate-mcp-server/commit/8b1f00c37467bc676ad8ec9ab672ba393ed084a9))
+* resolve linter errors in version detection code ([5f1f33e](https://github.com/aashari/boilerplate-mcp-server/commit/5f1f33e88ae843b7a0d708899713be36fcd2ec2e))
+* update examples to use correct API (greet instead of sayHello) ([7c062ca](https://github.com/aashari/boilerplate-mcp-server/commit/7c062ca42765c659f018f990f4b1ec563d1172d3))
+* update release workflow to ensure correct versioning in compiled files ([a365394](https://github.com/aashari/boilerplate-mcp-server/commit/a365394b8596defa33ff5a44583d52e2c43f0aa3))
+* update version display in CLI ([2b7846c](https://github.com/aashari/boilerplate-mcp-server/commit/2b7846cbfa023f4b1a8c81ec511370fa8f5aaf33))
+
+
+### Features
+
+* add automated dependency management ([efa1b62](https://github.com/aashari/boilerplate-mcp-server/commit/efa1b6292e0e9b6efd0d43b40cf7099d50769487))
+* add CLI usage examples for both JavaScript and TypeScript ([d5743b0](https://github.com/aashari/boilerplate-mcp-server/commit/d5743b07a6f2afe1c6cb0b03265228cba771e657))
+* add support for custom name in greet command ([be48a05](https://github.com/aashari/boilerplate-mcp-server/commit/be48a053834a1d910877864608a5e9942d913367))
+* add version update script and fix version display ([ec831d3](https://github.com/aashari/boilerplate-mcp-server/commit/ec831d3a3c966d858c15972365007f9dfd6115b8))
+* implement review recommendations ([a23cbc0](https://github.com/aashari/boilerplate-mcp-server/commit/a23cbc0608a07e202396b3cd496c1f2078e304c1))
+* implement testing, linting, and semantic versioning ([1d7710d](https://github.com/aashari/boilerplate-mcp-server/commit/1d7710dfa11fd1cb04ba3c604e9a2eb785652394))
+* improve CI workflows with standardized Node.js version, caching, and dual publishing ([0dc9470](https://github.com/aashari/boilerplate-mcp-server/commit/0dc94705c81067d7ff63ab978ef9e6a6e3f75784))
+* improve package structure and add better examples ([bd66891](https://github.com/aashari/boilerplate-mcp-server/commit/bd668915bde84445161cdbd55ff9da0b0af51944))
+
+
+### Reverts
+
+* restore simple version handling ([bd0fadf](https://github.com/aashari/boilerplate-mcp-server/commit/bd0fadfa8207b4a7cf472c3b9f4ee63d8e36189d))
+
+# [1.8.0](https://github.com/aashari/boilerplate-npm-package/compare/v1.7.2...v1.8.0) (2025-03-22)
+
+
+### Features
+
+* add CLI usage examples for both JavaScript and TypeScript ([d5743b0](https://github.com/aashari/boilerplate-npm-package/commit/d5743b07a6f2afe1c6cb0b03265228cba771e657))
+
+## [1.7.2](https://github.com/aashari/boilerplate-npm-package/compare/v1.7.1...v1.7.2) (2025-03-22)
+
+
+### Bug Fixes
+
+* update release workflow to ensure correct versioning in compiled files ([a365394](https://github.com/aashari/boilerplate-npm-package/commit/a365394b8596defa33ff5a44583d52e2c43f0aa3))
+
+## [1.7.1](https://github.com/aashari/boilerplate-npm-package/compare/v1.7.0...v1.7.1) (2025-03-22)
+
+
+### Bug Fixes
+
+* update examples to use correct API (greet instead of sayHello) ([7c062ca](https://github.com/aashari/boilerplate-npm-package/commit/7c062ca42765c659f018f990f4b1ec563d1172d3))
+
+# [1.7.0](https://github.com/aashari/boilerplate-npm-package/compare/v1.6.1...v1.7.0) (2025-03-22)
+
+
+### Features
+
+* improve package structure and add better examples ([bd66891](https://github.com/aashari/boilerplate-npm-package/commit/bd668915bde84445161cdbd55ff9da0b0af51944))
+
+## [1.6.1](https://github.com/aashari/boilerplate-npm-package/compare/v1.6.0...v1.6.1) (2025-03-22)
+
+
+### Bug Fixes
+
+* improve GitHub Packages publishing with better error handling and debugging ([db25f04](https://github.com/aashari/boilerplate-npm-package/commit/db25f04925e884349fcf3ab85316550fde231d1f))
+
+# [1.6.0](https://github.com/aashari/boilerplate-npm-package/compare/v1.5.2...v1.6.0) (2025-03-22)
+
+
+### Features
+
+* add support for custom name in greet command ([be48a05](https://github.com/aashari/boilerplate-npm-package/commit/be48a053834a1d910877864608a5e9942d913367))
+
+## [1.5.2](https://github.com/aashari/boilerplate-npm-package/compare/v1.5.1...v1.5.2) (2025-03-22)
+
+
+### Bug Fixes
+
+* add workflows permission to semantic-release workflow ([de3a335](https://github.com/aashari/boilerplate-npm-package/commit/de3a33510bd447af353444db1fcb58e1b1aa02e4))
+* improve GITHUB_OUTPUT syntax in semantic-release workflow ([6f154bc](https://github.com/aashari/boilerplate-npm-package/commit/6f154bc43f42475857e9256b0a671c3263dc9708))
+* make publish workflow more resilient against version conflicts ([ffd3705](https://github.com/aashari/boilerplate-npm-package/commit/ffd3705bc064ee9135402052a0dc7fe32645714b))
+* remove invalid workflows permission ([c012e46](https://github.com/aashari/boilerplate-npm-package/commit/c012e46a29070c8394f7ab596fe7ba68c037d3a3))
+
+## [1.5.2](https://github.com/aashari/boilerplate-npm-package/compare/v1.5.1...v1.5.2) (2025-03-22)
+
+
+### Bug Fixes
+
+* make publish workflow more resilient against version conflicts ([ffd3705](https://github.com/aashari/boilerplate-npm-package/commit/ffd3705bc064ee9135402052a0dc7fe32645714b))
+
+## [1.5.1](https://github.com/aashari/boilerplate-npm-package/compare/v1.5.0...v1.5.1) (2025-03-22)
+
+
+### Bug Fixes
+
+* improve GitHub Packages publishing with a more robust approach ([fd2aec9](https://github.com/aashari/boilerplate-npm-package/commit/fd2aec9926cf99d301cbb2b5f5ca961a6b6fec7e))
+
+# [1.5.0](https://github.com/aashari/boilerplate-npm-package/compare/v1.4.7...v1.5.0) (2025-03-22)
+
+
+### Features
+
+* improve CI workflows with standardized Node.js version, caching, and dual publishing ([0dc9470](https://github.com/aashari/boilerplate-npm-package/commit/0dc94705c81067d7ff63ab978ef9e6a6e3f75784))

package/README.md

@@ -0,0 +1,357 @@
+# Boilerplate MCP Server
+
+A boilerplate Model Context Protocol (MCP) server implementation using TypeScript. This project demonstrates how to build a well-structured MCP server that exposes both tools and resources to AI applications like Claude Desktop. It serves as a starting point for developers building MCP-compatible servers with a focus on clean architecture, automated workflows, and easy deployment.
+
+## Core Features
+
+- **STDIO MCP Server**: Designed for AI clients like Claude Desktop, providing tools and resources via the Model Context Protocol.
+- **CLI Support**: Human-friendly command-line interface for the same functionality, making it easy to test and use directly.
+- **IP Address Lookup**: Get details about any IP address or your current device's IP.
+- **Flexible Configuration**: Support for environment variables, .env files, and global config files.
+- **Testing & Development Tools**: Built-in inspection, testing, and development utilities.
+
+## Installation
+
+### Global Installation
+
+You can install this package globally to use as a CLI tool:
+
+```bash
+npm install -g @aashari/boilerplate-mcp-server
+```
+
+After global installation, you can run the CLI commands directly:
+
+```bash
+# Get help
+mcp-server --help
+
+# Get current IP details
+mcp-server get-ip-details
+
+# Get details for a specific IP
+mcp-server get-ip-details 8.8.8.8
+```
+
+### Local Installation
+
+For development or local use, clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/aashari/boilerplate-mcp-server.git
+cd boilerplate-mcp-server
+npm install
+```
+
+Then run the development server:
+
+```bash
+npm run dev
+```
+
+Or build and start:
+
+```bash
+npm run build
+npm start
+```
+
+## Developer Tools
+
+This project includes several scripts to make development easier:
+
+```bash
+# Run tests
+npm test
+
+# Check test coverage
+npm run test:coverage
+
+# Run linting
+npm run lint
+
+# Format code
+npm run format
+
+# Run the server with live reload during development
+npm run dev
+
+# Use the MCP Inspector to visually test your server
+npm run inspect
+
+# Use the MCP Inspector with debug mode enabled
+npm run inspect:debug
+```
+
+## Configuration Options for End Users
+
+Before setting up with Claude Desktop or Cursor AI, you can configure the server. There are two recommended options for end users:
+
+### Option 1: Direct Configuration in Claude/Cursor
+
+Pass your configuration directly in the Claude Desktop config or Cursor AI command:
+
+```json
+{
+	"mcpServers": {
+		"aashari/boilerplate-mcp-server": {
+			"command": "npx",
+			"args": [
+				"-y",
+				"DEBUG=true",
+				"IPAPI_API_TOKEN=your_token",
+				"@aashari/boilerplate-mcp-server"
+			]
+		}
+	}
+}
+```
+
+### Option 2: Global Configuration File (Recommended)
+
+1. Create a global configuration file at `$HOME/.mcp/configs.json`:
+
+```json
+{
+	"@aashari/boilerplate-mcp-server": {
+		"environments": {
+			"DEBUG": "true",
+			"IPAPI_API_TOKEN": "your_token"
+		}
+	}
+}
+```
+
+2. Then use a simplified configuration in Claude Desktop or Cursor AI:
+
+```json
+{
+	"mcpServers": {
+		"aashari/boilerplate-mcp-server": {
+			"command": "npx",
+			"args": ["-y", "@aashari/boilerplate-mcp-server"]
+		}
+	}
+}
+```
+
+This approach keeps your configuration in one secure location and simplifies your AI assistant setup.
+
+### Available Configuration Options
+
+- **DEBUG**: Set to `true` to enable debug logging.
+- **IPAPI_API_TOKEN**: API token for the IP API service (if required).
+
+## Setting Up with Claude Desktop
+
+To use this MCP server with Claude Desktop:
+
+1. **Open Claude Desktop Settings**:
+
+    - Launch Claude Desktop
+    - Click on the settings icon (gear) in the top-right corner
+
+2. **Edit MCP Configuration**:
+
+    - Click on "Edit Config" button
+    - This will open File Explorer/Finder with the `claude_desktop_config.json` file
+
+3. **Update Configuration File**:
+
+    - Add one of the configuration options from above to the file
+    - Save the file
+
+    Example with global configuration file already set up:
+
+    ```json
+    {
+    	"mcpServers": {
+    		"aashari/boilerplate-mcp-server": {
+    			"command": "npx",
+    			"args": ["-y", "@aashari/boilerplate-mcp-server"]
+    		}
+    	}
+    }
+    ```
+
+4. **Restart Claude Desktop**:
+
+    - Close and reopen Claude Desktop to apply the changes
+
+5. **Verify Tool Availability**:
+
+    - On the Claude home page, look for the hammer icon on the right side
+    - Click it to see available tools
+    - Ensure the `get-ip-details` tool is listed
+
+6. **Test the Tool**:
+
+    - Try asking Claude: "give me my public IP" or "analyze this IP: 8.8.8.8"
+    - Claude will use the MCP tool to fetch and display the requested information
+
+## Setting Up with Cursor AI
+
+To use this MCP server with Cursor AI:
+
+1. **Open Cursor Settings**:
+
+    - Launch Cursor
+    - Press `CMD + SHIFT + P` (or `CTRL + SHIFT + P` on Windows)
+    - Type "settings" and select "Cursor Settings"
+    - On the sidebar, select "MCP"
+
+2. **Add New MCP Server**:
+
+    - Click "+ Add new MCP server"
+    - A configuration form will appear
+
+3. **Configure MCP Server**:
+
+    - **Name**: Enter `aashari/boilerplate-mcp-server`
+    - **Type**: Select `command` from the dropdown
+    - **Command**: Choose one of the following based on your configuration approach:
+
+    If using global configuration file (recommended):
+
+    ```
+    npx -y @aashari/boilerplate-mcp-server
+    ```
+
+    If passing configuration directly:
+
+    ```
+    DEBUG=true IPAPI_API_TOKEN=your_token npx -y @aashari/boilerplate-mcp-server
+    ```
+
+    - Click "Add"
+
+4. **Verify Server Configuration**:
+
+    - The server should now be listed with a green indicator
+    - You should see the `get_ip_details` tool listed under the server
+
+5. **Test the Tool**:
+
+    - In the chat sidebar, ensure Agent mode is active
+    - Try asking: "give me my public IP" or "analyze this IP: 8.8.8.8"
+    - Cursor AI will use the MCP tool to fetch and display the requested information
+
+## Using as a CLI Tool
+
+The package can also be used as a command-line tool for human interaction:
+
+- **Get help and available commands**:
+
+    ```bash
+    npx -y @aashari/boilerplate-mcp-server --help
+    ```
+
+    Example output:
+
+    ```
+    Usage: @aashari/boilerplate-mcp-server [options] [command]
+
+    A boilerplate Model Context Protocol (MCP) server implementation using TypeScript
+
+    Options:
+      -V, --version               output the version number
+      -h, --help                  display help for command
+
+    Commands:
+      get-ip-details [ipAddress]  Get details about a specific IP address or the current device
+      help [command]              display help for command
+    ```
+
+- **Get current device IP details**:
+
+    ```bash
+    npx -y @aashari/boilerplate-mcp-server get-ip-details
+    ```
+
+    Example output:
+
+    ```
+    status: success
+    country: Indonesia
+    countryCode: ID
+    region: JK
+    regionName: Jakarta
+    city: Jakarta
+    zip: 11730
+    lat: -6.2114
+    lon: 106.8446
+    timezone: Asia/Jakarta
+    isp: Biznet Wifi
+    org:
+    as: AS17451 BIZNET NETWORKS
+    query: 118.99.106.135
+    ```
+
+    - **Get details for a specific IP address**:
+
+    ```bash
+    npx -y @aashari/boilerplate-mcp-server get-ip-details 8.8.8.8
+    ```
+
+    Example output:
+
+    ```
+    status: success
+    country: United States
+    countryCode: US
+    region: VA
+    regionName: Virginia
+    city: Ashburn
+    zip: 20149
+    lat: 39.03
+    lon: -77.5
+    timezone: America/New_York
+    isp: Google LLC
+    org: Google Public DNS
+    as: AS15169 Google LLC
+    query: 8.8.8.8
+    ```
+
+## For Developers
+
+### MCP Inspector Usage
+
+This project includes integration with MCP Inspector for easy debugging and testing:
+
+```bash
+# Launch the MCP Inspector with your server
+npm run inspect
+
+# Launch with debug mode enabled
+npm run inspect:debug
+```
+
+When you run the inspector:
+
+1. The Inspector will start your MCP server
+2. It will launch a web UI (typically at http://localhost:5173)
+3. You can use the UI to interact with your server and test its functionality
+
+The inspector provides a visual way to see:
+
+- Your server's tools and resources
+- The requests and responses between client and server
+- Any errors that occur during communication
+
+## About MCP
+
+The Model Context Protocol (MCP) is an open standard developed by Anthropic to simplify how AI systems connect to external data sources and tools. For detailed information, including core concepts, architecture, and implementation guides, please refer to the [official MCP documentation](https://modelcontextprotocol.io/docs/).
+
+## Extending This Project
+
+To add your own tools and resources:
+
+1. Create service files in the `src/services` directory
+2. Implement controllers in `src/controllers`
+3. Create tool implementations in `src/tools`
+4. Create resource implementations in `src/resources`
+5. Register your new tools and resources in `src/index.ts`
+
+## License
+
+[ISC](https://opensource.org/licenses/ISC)

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export declare function runCli(args: string[]): Promise<void>;

package/dist/cli/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+const commander_1 = require("commander");
+const logger_util_js_1 = require("../utils/logger.util.js");
+const ipaddress_cli_js_1 = __importDefault(require("./ipaddress.cli.js"));
+// Get the version from package.json
+const VERSION = '1.0.0'; // This should match the version in src/index.ts
+const NAME = '@aashari/boilerplate-mcp-server';
+const DESCRIPTION = 'A boilerplate Model Context Protocol (MCP) server implementation using TypeScript';
+async function runCli(args) {
+    const program = new commander_1.Command();
+    program.name(NAME).description(DESCRIPTION).version(VERSION);
+    // Register CLI commands
+    ipaddress_cli_js_1.default.register(program);
+    // Handle unknown commands
+    program.on('command:*', (operands) => {
+        logger_util_js_1.logger.error(`[src/cli/index.ts] Unknown command: ${operands[0]}`);
+        console.log('');
+        program.help();
+        process.exit(1);
+    });
+    // Parse arguments; default to help if no command provided
+    await program.parseAsync(args.length ? args : ['--help'], { from: 'user' });
+}

package/dist/cli/index.js.bak

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+const commander_1 = require("commander");
+const logger_util_js_1 = require("../utils/logger.util.js");
+const ipaddress_cli_js_1 = __importDefault(require("./ipaddress.cli.js"));
+// Get the version from package.json
+const VERSION = '1.1.0'; // This should match the version in src/index.ts
+const NAME = '@aashari/boilerplate-mcp-server';
+const DESCRIPTION = 'A boilerplate Model Context Protocol (MCP) server implementation using TypeScript';
+async function runCli(args) {
+    const program = new commander_1.Command();
+    program.name(NAME).description(DESCRIPTION).version(VERSION);
+    // Register CLI commands
+    ipaddress_cli_js_1.default.register(program);
+    // Handle unknown commands
+    program.on('command:*', (operands) => {
+        logger_util_js_1.logger.error(`[src/cli/index.ts] Unknown command: ${operands[0]}`);
+        console.log('');
+        program.help();
+        process.exit(1);
+    });
+    // Parse arguments; default to help if no command provided
+    await program.parseAsync(args.length ? args : ['--help'], { from: 'user' });
+}

package/dist/cli/ipaddress.cli.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+/**
+ * Register IP address CLI commands
+ * @param program The Commander program instance
+ */
+declare function register(program: Command): void;
+declare const _default: {
+    register: typeof register;
+};
+export default _default;

package/dist/cli/ipaddress.cli.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_util_js_1 = require("../utils/logger.util.js");
+const error_util_js_1 = require("../utils/error.util.js");
+const ipaddress_controller_js_1 = __importDefault(require("../controllers/ipaddress.controller.js"));
+/**
+ * Register IP address CLI commands
+ * @param program The Commander program instance
+ */
+function register(program) {
+    logger_util_js_1.logger.debug(`[src/cli/ipaddress.cli.ts@register] Registering IP address CLI commands...`);
+    program
+        .command('get-ip-details')
+        .description('Get details about a specific IP address or the current device')
+        .argument('[ipAddress]', 'IP address to lookup (optional)')
+        .action(async (ipAddress) => {
+        try {
+            logger_util_js_1.logger.debug(`[src/cli/ipaddress.cli.ts@get-ip-details] Fetching IP details for ${ipAddress || 'current device'}...`);
+            const result = await ipaddress_controller_js_1.default.get(ipAddress);
+            logger_util_js_1.logger.debug(`[src/cli/ipaddress.cli.ts@get-ip-details] IP details fetched successfully`, result);
+            console.log(result.content);
+        }
+        catch (error) {
+            (0, error_util_js_1.handleCliError)(error);
+        }
+    });
+}
+exports.default = { register };

package/dist/controllers/ipaddress.controller.d.ts

@@ -0,0 +1,7 @@
+declare function get(ipAddress?: string): Promise<{
+    content: string;
+}>;
+declare const _default: {
+    get: typeof get;
+};
+export default _default;

package/dist/controllers/ipaddress.controller.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vendor_ip_api_com_service_js_1 = __importDefault(require("../services/vendor.ip-api.com.service.js"));
+const logger_util_js_1 = require("../utils/logger.util.js");
+const error_util_js_1 = require("../utils/error.util.js");
+async function get(ipAddress) {
+    logger_util_js_1.logger.debug(`[src/controllers/ipaddress.controller.ts@get] Getting IP address details...`);
+    try {
+        const ipData = await vendor_ip_api_com_service_js_1.default.get(ipAddress);
+        logger_util_js_1.logger.debug(`[src/controllers/ipaddress.controller.ts@get] Got the response from the service`, ipData);
+        const lines = [];
+        for (const [key, value] of Object.entries(ipData)) {
+            lines.push(`${key}: ${value}`);
+        }
+        return {
+            content: lines.join('\n'),
+        };
+    }
+    catch (error) {
+        // Log the error
+        logger_util_js_1.logger.error(`[src/controllers/ipaddress.controller.ts@get] Error getting IP details`, error);
+        // Pass McpErrors through
+        if (error instanceof error_util_js_1.McpError) {
+            throw error;
+        }
+        // Wrap other errors
+        throw (0, error_util_js_1.createUnexpectedError)('Failed to get IP address details', error);
+    }
+}
+exports.default = { get };

package/dist/controllers/ipaddress.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { logger } from './utils/logger.util.js';
+import { config } from './utils/config.util.js';
+export declare function startServer(mode?: 'stdio' | 'sse'): Promise<void>;
+export { logger, config };
+export * from './utils/error.util.js';