Boilerplate MCP Server
About
A comprehensive TypeScript implementation of the Model Context Protocol (MCP) server with tools, resources, and prompts for LLM integration. Provides a robust foundation for building AI-powered applications with CLI support.
Explore
- 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.
- Automated Release Management: GitHub Actions workflow for continuous integration, testing, and publishing to GitHub Packages.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Boilerplate MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
The package can also be used as a command-line tool for human interaction:
- Get help and available commands:
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:
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:
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
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"boilerplate mcp server": {
"personal-mcp-server": {
"command": "npx",
"args": [
"-y",
"aashari/boilerplate-mcp-server",
"--help"
]
}
}
}
}McpServers
{
"personal-mcp-server": {
"command": "npx",
"args": [
"-y",
"aashari/boilerplate-mcp-server",
"--help"
]
}
}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.
- Automated Release Management: GitHub Actions workflow for continuous integration, testing, and publishing to GitHub Packages.
Installation
Global Installation
You can install this package globally to use as a CLI tool:
npm install -g @aashari/boilerplate-mcp-server
After global installation, you can run the CLI commands directly:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
