@aashari/boilerplate-mcp-server 1.3.4 → 1.3.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
## [1.3.5](https://github.com/aashari/boilerplate-mcp-server/compare/v1.3.4...v1.3.5) (2025-04-25)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Bug Fixes
|
|
5
|
+
|
|
6
|
+
* rename IP tool to 'ip_get_details' for naming consistency ([fb2a5c6](https://github.com/aashari/boilerplate-mcp-server/commit/fb2a5c6df0766f608e5e06f6f13326a4821e6760))
|
|
7
|
+
* unify tool description for clarity and consistency ([006460b](https://github.com/aashari/boilerplate-mcp-server/commit/006460bacd1413b3254e45c6085b07f27a468898))
|
|
8
|
+
|
|
1
9
|
## [1.3.4](https://github.com/aashari/boilerplate-mcp-server/compare/v1.3.3...v1.3.4) (2025-04-22)
|
|
2
10
|
|
|
3
11
|
|
|
@@ -53,47 +53,7 @@ async function getIpAddressDetails(args) {
|
|
|
53
53
|
function registerTools(server) {
|
|
54
54
|
const methodLogger = logger_util_js_1.Logger.forContext('tools/ipaddress.tool.ts', 'registerTools');
|
|
55
55
|
methodLogger.debug(`Registering IP address tools...`);
|
|
56
|
-
server.tool('
|
|
57
|
-
|
|
58
|
-
PURPOSE:
|
|
59
|
-
Retrieves geolocation information (country, city, region, coordinates), ISP, and organization details associated with an IP address. Provides network and geographical context for an IP, which is useful for security analysis, debugging, or location verification.
|
|
60
|
-
|
|
61
|
-
WHEN TO USE:
|
|
62
|
-
- To find the geographical location of a given IP address (country, region, city, coordinates).
|
|
63
|
-
- To identify the ISP or organization owning an IP address.
|
|
64
|
-
- To get your own public IP address details (by omitting the 'ipAddress' argument).
|
|
65
|
-
- When analyzing network traffic or connections for geographical context.
|
|
66
|
-
- When verifying a user's approximate location based on their IP.
|
|
67
|
-
- When investigating suspicious IP addresses in logs.
|
|
68
|
-
|
|
69
|
-
WHEN NOT TO USE:
|
|
70
|
-
- For internal/private IP addresses (e.g., 10.x.x.x, 192.168.x.x) as this tool queries a public database.
|
|
71
|
-
- When you need historical IP data (this provides current lookup only).
|
|
72
|
-
- For precise geolocation (IP geolocation accuracy is limited).
|
|
73
|
-
- For operations other than retrieving IP geolocation details.
|
|
74
|
-
- When processing large batches of IPs without considering rate limits.
|
|
75
|
-
|
|
76
|
-
RETURNS:
|
|
77
|
-
Formatted Markdown containing:
|
|
78
|
-
- Location information (country, region, city, postal code, coordinates)
|
|
79
|
-
- Network details (ISP, organization, AS number/name)
|
|
80
|
-
- A link to view the location on a map.
|
|
81
|
-
- Timestamp of when the information was retrieved.
|
|
82
|
-
- With 'includeExtendedData=true', additional details like reverse DNS, mobile/proxy/hosting detection may be included.
|
|
83
|
-
|
|
84
|
-
EXAMPLES:
|
|
85
|
-
- Get details for a specific IP: { ipAddress: "8.8.8.8" }
|
|
86
|
-
- Get details with extended data: { ipAddress: "1.1.1.1", includeExtendedData: true }
|
|
87
|
-
- Get details for current device using HTTPS: { useHttps: true }
|
|
88
|
-
- Get basic details for current device: {}
|
|
89
|
-
|
|
90
|
-
ERRORS:
|
|
91
|
-
- Invalid IP format: If 'ipAddress' is not a valid IPv4 or IPv6 format.
|
|
92
|
-
- Private/Reserved IP: If the IP address is in a private or reserved range (per ip-api.com rules).
|
|
93
|
-
- API errors: If the external ip-api.com service fails, rejects the request (e.g., bad token), or returns an error status.
|
|
94
|
-
- Rate limiting: If the ip-api.com service rate limits the request.
|
|
95
|
-
- Network errors: If the request to ip-api.com fails due to network issues.`, // Keep Zod schema reference
|
|
96
|
-
ipaddress_types_js_1.IpAddressToolArgs.shape, getIpAddressDetails);
|
|
56
|
+
server.tool('ip_get_details', `Retrieves geolocation and network details for a public IP address (\`ipAddress\`). If no IP is provided, returns details for the server's current public IP.\n- Fetches country, city, region, coordinates, ISP, and organization.\n- Optional \`includeExtendedData\` can provide reverse DNS, mobile/proxy/hosting detection.\nUse this to get geographical or network context for a public IP address.\nReturns formatted Markdown with location, network details, map link, and timestamp.\n**Note:** Does not work for private/reserved IP addresses. Relies on the external ip-api.com service.`, ipaddress_types_js_1.IpAddressToolArgs.shape, getIpAddressDetails);
|
|
97
57
|
methodLogger.debug('Successfully registered get-ip-details tool.');
|
|
98
58
|
}
|
|
99
59
|
exports.default = { registerTools };
|
|
@@ -11,7 +11,7 @@ exports.CLI_NAME = exports.PACKAGE_NAME = exports.VERSION = void 0;
|
|
|
11
11
|
* Current application version
|
|
12
12
|
* This should match the version in package.json
|
|
13
13
|
*/
|
|
14
|
-
exports.VERSION = '1.3.
|
|
14
|
+
exports.VERSION = '1.3.5';
|
|
15
15
|
/**
|
|
16
16
|
* Package name with scope
|
|
17
17
|
* Used for initialization and identification
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aashari/boilerplate-mcp-server",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.5",
|
|
4
4
|
"description": "TypeScript Model Context Protocol (MCP) server boilerplate providing IP lookup tools/resources. Includes CLI support and extensible structure for connecting AI systems (LLMs) to external data sources like ip-api.com. Ideal template for creating new MCP integrations via Node.js.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
package/package.json.bak
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aashari/boilerplate-mcp-server",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.4",
|
|
4
4
|
"description": "TypeScript Model Context Protocol (MCP) server boilerplate providing IP lookup tools/resources. Includes CLI support and extensible structure for connecting AI systems (LLMs) to external data sources like ip-api.com. Ideal template for creating new MCP integrations via Node.js.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|