MCP.so
ログイン

MCP Server Boilerplate (TypeScript)

@Falkicon

基本情報

カテゴリ

開発者ツール

ライセンス

MIT

トランスポート

stdio

作者

Falkicon

MCP Server Boilerplate について

TypeScript boilerplate for MCP servers using the official SDK, with support for stdio/http, logging, docker, and tests.

MCP Server Boilerplate の設定

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

{
  "mcpServers": {
    "mcp-server-template-falkicon": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-server-boilerplate",
        "."
      ]
    }
  }
}

MCP Server Boilerplate のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

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

概要

What is MCP Server Boilerplate (TypeScript)?

A well-structured, maintainable boilerplate for building Model Context Protocol (MCP) servers in TypeScript. It uses the official @modelcontextprotocol/sdk with stdio transport and includes example tools, resources, and prompts to accelerate development.

How to use MCP Server Boilerplate (TypeScript)?

Clone the repository, run npm install, optionally copy .env.example to .env and configure environment variables. For development, use npm run dev (hot‑reload with pretty logs); for production, run npm run build then npm start. A Docker image can be built via docker build -t mcp-server-boilerplate . and run with docker run -i --rm mcp-server-boilerplate. Configure clients like Cursor by pointing mcp.json to the compiled dist/index.js --stdio.

Key features of MCP Server Boilerplate (TypeScript)

  • TypeScript, MCP SDK, and stdio transport
  • Example primitives: greet and add tools, welcome resource, summarize prompt
  • Configuration via .env files and environment variables
  • Input validation with Zod, structured logging with pino, custom error classes
  • Multi‑stage Dockerfile, ESLint/Prettier, testing with Vitest

Use cases of MCP Server Boilerplate (TypeScript)

  • Starting a new MCP server project with best practices baked in
  • Learning the MCP protocol through working examples
  • Building extensible MCP integrations for AI assistants
  • Rapidly prototyping tools, resources, and prompts

よくある質問

1

What transport does the server use?

It uses stdio transport by default, sending JSON‑RPC messages over standard input/output.

2

How do I configure logging?

Set `LOG_LEVEL` (default `info`) and `NODE_ENV` (default `development`, enabling pretty logs; set to `production` for JSON logs).

3

Can users directly invoke MCP tools in chat?

No. MCP tools are designed to be called by the AI assistant, not directly by users. The AI discovers and invokes tools on behalf of the user.

4

What are the known limitations?

AI model compatibility for tool invocation can vary. Cursor currently only supports tools (not resources/prompts) and sends only the first 40 tools to the Agent. Remote development over SSH may not work properly.

5

How do I add a new tool?

Define a Zod schema for arguments, then use `server.tool(name, schemaDefinition, handler)`. Register tools with simple names only (e.g., `"add"`); the client automatically prefixes them for AI calls.

コメント

「開発者ツール」の他のコンテンツ