MCP Server TypeScript Starter

by yhwancha

200 downloads Not rated yet

About

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

Explore

- 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

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

npm install mylocation-mcp

npm install

cp .env.example .env

To use this MCP server in your project, add the following configuration:

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

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": ""
        }
    }
}

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.