MCP cover image
See in Github
2025-04-04

TypeScript de build sans build pour une implémentation de serveur MCP

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.

preview

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.

相关推荐

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • https://zenepic.net
  • 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.

  • apappascs
  • Découvrez la collection la plus complète et la plus à jour de serveurs MCP sur le marché. Ce référentiel sert de centre centralisé, offrant un vaste catalogue de serveurs MCP open-source et propriétaires, avec des fonctionnalités, des liens de documentation et des contributeurs.

  • ShrimpingIt
  • Manipulation basée sur Micropython I2C de l'exposition GPIO de la série MCP, dérivée d'Adafruit_MCP230XX

  • modelcontextprotocol
  • Serveurs de protocole de contexte modèle

  • Mintplex-Labs
  • L'application tout-en-un desktop et Docker AI avec chiffon intégré, agents AI, constructeur d'agent sans code, compatibilité MCP, etc.

  • ravitemer
  • Un puissant plugin Neovim pour gérer les serveurs MCP (Protocole de contexte modèle)

  • jae-jae
  • MCP Server pour récupérer le contenu de la page Web à l'aide du navigateur sans tête du dramwright.

  • patruff
  • Pont entre les serveurs Olllama et MCP, permettant aux LLM locaux d'utiliser des outils de protocole de contexte de modèle

  • pontusab
  • La communauté du curseur et de la planche à voile, recherchez des règles et des MCP

  • WangRongsheng
  • 🧑‍🚀 全世界最好的 LLM 资料总结 (数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型) | Résumé des meilleures ressources LLM du monde.

    Reviews

    4 (1)
    Avatar
    user_XnBVLiPL
    2025-04-17

    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.