MCP Server TypeScript Starter
@yhwancha
About MCP Server TypeScript Starter
A Model Context Protocol (MCP) server that provides location services
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
Fetch the live tool list by running this server in a temporary sandbox using the button above.
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.
Frequently asked questions
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.
Basic information
More Developer Tools MCP servers
FastAPI-MCP
tadata-orgExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!
BetterBugs
BetterBugsThe BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C
PuzzleTide Puzzle Generator
Caravaca-LabsWord 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
MCP Containers
metorialConnect any AI model to 1200+ integrations (MCP, CLI, API)
TalkToFigma
sonnylazuardiTalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.
Comments