MCP Server TypeScript Starter

by yhwancha

200 downloads
Not rated
GitHub

About

A Model Context Protocol (MCP) server that provides location services

Details

Author
yhwancha
Downloads
200
Categories
Developer Tools

- Full TypeScript configuration and type-safe development environment
- Complete MCP server setup with tool registration
- Coordinate-based location lookup tool
- IP-based location lookup using IPInfo.io API
- Health check endpoint for service monitoring
- Integration with external APIs via axios

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Server TypeScript Starter
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the package via npm install mylocation-mcp, create a .env file with your IPInfo.io API token (IPINFO_TOKEN), then import and use the server in your TypeScript code. Alternatively, configure the server in your project’s MCP settings using the provided npx command with the environment variable set.

get-location-by-coordinates

Get location information from provided coordinates

get-location-by-ip

Get location information from IP address

get-my-location

Get location information using current IP address via ipify and ipinfo

health

Check the health status of the service

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp server typescript starter": {
            "location-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mylocation-mcp-server"
                ],
                "env": {
                    "IPINFO_TOKEN": ""
                }
            }
        }
    }
}

McpServers

{
    "location-service": {
        "command": "npx",
        "args": [
            "-y",
            "mylocation-mcp-server"
        ],
        "env": {
            "IPINFO_TOKEN": ""
        }
    }
}

MCP Server TypeScript Starter

This is a Model Context Protocol (MCP) server implementation that provides location services. It demonstrates how to build an MCP server using TypeScript with real-world functionality for location lookups via coordinates or IP addresses.

Features

- TypeScript configuration
- Complete MCP server setup
- Location service implementation
- Coordinate-based location lookup
- IP-based location lookup (using IPInfo.io)
- Health check endpoint
- Type-safe development environment
- Integration with external APIs

Installation

npm install mylocation-mcp

Usage

1. Create a .env file with your IPInfo.io API token:

IPINFO_TOKEN=your_ipinfo_token_here

2. Import and use in your code:

import { McpServer } from 'mylocation-mcp';

Development

If you want to modify or contribute to the package:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.