
mcp-ts-quickstart
Build-less TypeScript quickstart for an MCP server implementation
1
Github Watches
0
Github Forks
0
Github Stars
MCP TS Quickstart
This is a quickstart for MCP in TypeScript.
It includes a basic MCP server implementation that uses the stdio
transport,
and fetches the top stories from Hacker News.
It is written in TypeScript and works without a build step by utilizing Node v23.
Based on the example provided in the MCP documentation.
Usage
The snippet below requires git
, nvm
, and pnpm
.
git clone git@github.com:cephalization/mcp-ts-quickstart.git
cd mcp-ts-quickstart
nvm install && nvm use
pnpm install
Once cloned and dependencies installed, you can add this server to Claude Desktop with a config similar to the following:
{
"mcpServers": {
"hacker-news": {
"command": "/Users/tony/.nvm/versions/node/v23.6.0/bin/node",
"args": ["/Users/tony/repos/mcp/src/index.ts"]
}
}
}
See the MCP documentation for more information on how to use Claude Desktop as a client.
Development
The following commands will install the dependencies, and then start the MCP server with the MCP Inspector UI as a client.
nvm install && nvm use
pnpm install
pnpm start
Because the server is build-less, you can simply "restart" the server inside of the inspector UI by pressing the "Restart" button.
Extending the server
The server is implemented in src/index.ts
.
The topStories
tool is implemented in src/tools.ts
.
To add a new tool, you can copy the topStories
tool and modify it.
When importing local src files, make sure to use the .ts
extension so that node can resolve it.
When importing types, make sure to add the type
keyword in front of the import so that node can strip it out at runtime.
When importing libraries, make sure to import the actual source file extension, if it does not provide an exports mapping.
MCP Inspector
The MCP Inspector is a UI for interacting with MCP servers.
When run, it will be available at http://localhost:6274.
相关推荐
I find academic articles and books for research and literature reviews.
Confidential guide on numerology and astrology, based of GG33 Public information
Converts Figma frames into front-end code for various mobile frameworks.
Advanced software engineer GPT that excels through nailing the basics.
Take an adjectivised noun, and create images making it progressively more adjective!
Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.
Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.
Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx
The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.
Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools
🧑🚀 全世界最好的LLM资料总结(Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.
Reviews

user_XnBVLiPL
I recently used the mcp-ts-quickstart by cephalization and it has significantly streamlined my TypeScript project setup. The GitHub link (https://github.com/cephalization/mcp-ts-quickstart) provides an excellent starting point with clear instructions and a user-friendly structure. Highly recommend for developers looking to save time and enhance productivity.