MCP TypeScript Server Starter

Name: MCP TypeScript Server Starter
Author: ralf-boltshauser

@ralf-boltshauser

リポジトリ

MCP TypeScript Server Starter について

概要はまだありません

基本情報

カテゴリ

開発者ツール

ライセンス

MIT

ランタイム

html

トランスポート

stdio

公開者

ralf-boltshauser

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-typescript-server-starter": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://subdomain.yourdomain.com/sse"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is MCP TypeScript Server Starter?

A starter project for building Model Context Protocol (MCP) servers in TypeScript. It includes a simple echo server that demonstrates tools, resources, and prompts, and supports both STDIO and SSE communication modes.

How to use MCP TypeScript Server Starter?

Clone the repository, install dependencies with pnpm install, and run pnpm dev to start the development server with an inspector at http://localhost:6274. To switch between STDIO and SSE modes, comment/uncomment the corresponding code blocks in src/index.ts. Deploy with Docker or Coolify, and connect via npx -y mcp-remote https://your-domain.com/sse.

Key features of MCP TypeScript Server Starter

Simple echo server with tool, resource, and prompt implementations
Supports STDIO (local) and SSE (remote) communication
Built-in web inspector for testing and debugging
Hot-reloading development server
TypeScript type safety and modern tooling
Easy deployment to Coolify and other platforms

Use cases of MCP TypeScript Server Starter

Quickly prototype and test an MCP server locally
Integrate an echo server with Cursor or Claude Desktop
Deploy a production‑ready MCP server via SSE for remote access
Use as a reference for building custom tools, resources, or prompts
Experiment with MCP debugging and environment variable handling

FAQ from MCP TypeScript Server Starter

What is the difference between STDIO and SSE modes?

STDIO mode uses direct process communication and is ideal for local development with tools like Cursor or Claude Desktop. SSE mode uses HTTP/SSE and is better for production deployments and remote access.

What are the prerequisites?

Node.js v16 or later and pnpm (or npm) are required.

How do I test the server locally?

Run pnpm dev, open the inspector at http://localhost:6274, click “Connect”, go to “Tools”, “List Tools”, select “echo”, write a message, and submit.

How do I deploy to Coolify?

Disable GZIP compression, ensure port 3001 is exposed, and set the domain with :3001 suffix (e.g. https://subdomain.yourdomain.com:3001). Then connect clients with npx -y mcp-remote https://subdomain.yourdomain.com/sse.

How do I add custom tools, resources, or prompts?

Edit src/index.ts — the file contains commented examples for adding tools (functions your AI can call), resources (data your AI can access), and prompts (templates for AI interactions).