MCP Server TypeScript Starter

@yhwancha

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

yhwancha

关于 MCP Server TypeScript Starter

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

MCP Server TypeScript Starter 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

MCP Server TypeScript Starter 工具

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

概览

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

常见问题

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.

开发工具分类下的更多 MCP 服务器

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

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.