MCP TS Quickstart

What is MCP TS Quickstart?

MCP TS Quickstart is a basic MCP (Model Context Protocol) server implementation in TypeScript that fetches the top stories from Hacker News. It uses the stdio transport and requires no build step by utilizing Node v23. It is intended for developers learning MCP or prototyping MCP-based applications.

How to use MCP TS Quickstart?

Clone the repository, install dependencies with nvm and pnpm, then add the server to Claude Desktop using a JSON configuration that points to Node v23 and the src/index.ts file. Alternatively, run pnpm start to launch the server with the MCP Inspector UI for development and testing.

Key features of MCP TS Quickstart

• Basic MCP server using stdio transport
• Fetches top stories from Hacker News
• Written in TypeScript without a build step
• Requires Node v23
• Easily extendable by adding new tools
• Integrated with MCP Inspector for local testing

Use cases of MCP TS Quickstart

• Learning how to create an MCP server in TypeScript
• Quickly prototyping an MCP tool that interacts with Hacker News
• Experimenting with the Model Context Protocol without complex setup
• Extending the server with custom tools for other data sources

FAQ from MCP TS Quickstart

What runtime does MCP TS Quickstart require?

It requires Node v23, as configured via nvm in the setup instructions.

Does MCP TS Quickstart require a build step?

No, it works without a build step by using Node v23's native TypeScript support.

How do I add a new tool to MCP TS Quickstart?

Copy the existing topStories tool from src/tools.ts, modify it, and register the new tool in src/index.ts. When importing local source files, use the .ts extension, and use type keyword for type imports.

How can I test the MCP TS Quickstart server?

Run pnpm start to launch the server with the MCP Inspector UI, available at http://localhost:6274. You can then interact with tools and restart the server from the UI.

How do I configure MCP TS Quickstart with Claude Desktop?

Add a JSON object under mcpServers in Claude Desktop's configuration, specifying the command as the path to Node v23 and args as the path to src/index.ts. See the MCP documentation for details.