Simple MCP Server

A starter MCP server built with TypeScript and the official MCP SDK, featuring example tools like echo, add, time, and flight status.

A simple Model Context Protocol (MCP) server implementation using TypeScript and the official MCP SDK.

- echo: Echoes back the input text
- add_numbers: Adds two numbers together
- get_current_time: Returns the current date and time
- get_flight_status: Get real-time flight status using flight number (supports both mock and real API data)

- info://server: Server information and capabilities
- greeting://hello: A simple greeting message

Run the server in development mode with hot reloading:

To use this server with an MCP client, you'll need to configure the client to connect to this server. The server uses stdio transport, so it can be launched as a subprocess.

{ "mcpServers": { "simple-server": { "command": "node", "args": ["path/to/dist/index.js"] } } }

├── examples/ # Example implementations │ ├── resources/ │ │ └── example-resource.ts # Example resource implementations │ └── tools/ │ └── example-tool.ts # Example tool implementations ├── src/ # Source code │ ├── handlers/ │ │ └── index.ts # MCP request handlers │ ├── resources/ │ │ ├── index.ts # Resource implementations │ │ └── registry.ts # Resource registry │ ├── tools/ │ │ ├── index.ts # Tool implementations │ │ └── registry.ts # Tool registry │ ├── types/ │ │ └── index.ts # TypeScript type definitions │ ├── utils/ │ │ └── config.ts # Configuration and utilities │ ├── index.ts # Main entry point │ └── server.ts # Core server implementation ├── dist/ # Compiled JavaScript (generated) ├── package.json # Node.js dependencies and scripts ├── tsconfig.json # TypeScript configuration ├── test.js # Basic test script ├── test-comprehensive.js # Comprehensive test script └── README.md # This file

The server is built with a modular architecture that makes it easy to extend:

- Tools: Each tool is a separate class implementing theToolHandlerinterface
- Resources: Each resource is a separate class implementing theResourceHandlerinterface
- Registries: Central registries manage all tools and resources
- Handlers: Request handlers manage MCP protocol communication
- Types: Shared TypeScript interfaces for type safety
- Create a new tool class implementingToolHandlerinsrc/tools/
- Add the tool to theToolRegistryinsrc/tools/registry.ts
- Seeexamples/tools/example-tool.tsfor a complete example
- Create a new resource class implementingResourceHandlerinsrc/resources/
- Add the resource to theResourceRegistryinsrc/resources/registry.ts
- Seeexamples/resources/example-resource.tsfor complete examples

The flight status tool provides real-time flight information:

- Real-time flight status (scheduled, active, landed, cancelled, delayed)
- Departure and arrival airport information
- Airline details
- Scheduled times
- International flight support

# Test the flight status tool node test-flight-status.js

API Integration:By default, the tool uses mock data. To get real flight data:
- Sign up for a free API key atAviationStack
- Set the environment variable:AVIATIONSTACK_API_KEY=your_api_key
- Rebuild and restart the server

# Basic test node test.js # Comprehensive test with all features node test-comprehensive.js # Test flight status tool specifically node test-flight-status.js

For more information about MCP, visit:https://modelcontextprotocol.io/

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB