MCP Server TypeScript Starter

Name: MCP Server TypeScript Starter
Author: yhwancha

@yhwancha

Repository

About MCP Server TypeScript Starter

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

Basic information

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

FAQ from MCP Server TypeScript Starter

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.

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.

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.

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).

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

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

Minecraft MCP Server

yuniko-software

A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction

642