Advertise
MCP.so
Sign In

MCP Server TypeScript Starter

@yhwancha

Repository

Basic information

Category

Developer Tools

Last updated

Transports

stdio

Author

yhwancha

About MCP Server TypeScript Starter

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

MCP Server TypeScript Starter config

Add this server to your MCP-compatible client using the configuration below.

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

MCP Server TypeScript Starter tools

4

Get location information from provided coordinates

Get location information from IP address

Get location information using current IP address via ipify and ipinfo

Check the health status of the service

Overview

What is MCP Server TypeScript Starter?

MCP Server TypeScript Starter is a Model Context Protocol (MCP) server implementation that provides location services. It demonstrates how to build a production-ready MCP server using TypeScript with real-world functionality for looking up location data via geographic coordinates or IP addresses. The server is intended for developers who want a reference implementation or a starting point for their own MCP services.

How to use MCP Server TypeScript Starter?

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.

Key features of MCP Server TypeScript Starter

  • 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

Use cases of MCP Server TypeScript Starter

  • Quickly prototype a location-aware MCP server for chat or agent applications
  • Learn how to structure a TypeScript-based MCP server with external API calls
  • Provide location lookup as a tool in an MCP-enabled assistant or IDE
  • Use as a template for building your own custom MCP services

Frequently asked questions

1

What dependencies does the server use?

The server requires `@modelcontextprotocol/sdk`, `zod` for input validation, `axios` for HTTP requests, `dotenv` for environment variable management, and TypeScript development tools.

2

What API key is required?

You need an IPInfo.io API token (`IPINFO_TOKEN`) to use the IP-based location lookup. The token is set as an environment variable.

3

How do I configure the MCP server in my project?

Add an entry to your MCP configuration object with command `npx`, arguments `["-y", "mylocation-mcp-server"]`, and environment variable `IPINFO_TOKEN`.

4

What format do the tool responses follow?

Responses are JSON objects wrapped in a standard MCP content array. Each response contains a `status` (“success” or “error”), a `source` (“user_provided” or “ip_based”), a `data` field with location information (on success), and an `error` field with an error message (on failure).

5

Does the server support any other lookup methods?

The README describes three tools: coordinate-based lookup, IP-based lookup, and a health check. No other lookup methods are mentioned.

Comments

More Developer Tools MCP servers

OSIR Domain Name MCP Server

Osir

Remote MCP server from OSIR, an ICANN-accredited registrar: 105 tools and 11 prompts to search, register, renew, transfer, and manage domains, DNS, VPS, email, and websites from Claude, ChatGPT, Cursor, or any MCP client

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

PuzzleTide Puzzle Generator

Caravaca-Labs

Word search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

1

Modelglass

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

1
Advertise