Hello World MCP サーバー

Hello World MCP Serverへようこそ！このプロジェクトでは、Model Context Protocol (MCP) SDK を使用してサーバーをセットアップする方法を説明します。サーバー送信イベント (SSE) とメッセージを処理するためのツール、プロンプト、エンドポイントが含まれています。

このプロジェクトは、ブログ記事「TypeScript MCPサーバーの構築：既存サービスの統合ガイド」の一部です。このプロジェクトの背景にあるコンセプトや実装の詳細については、ブログをご覧ください。

特徴

MCP 統合: MCP SDK を使用して、ツールとプロンプトを備えたサーバーを作成します。
Express Framework : SSE およびメッセージ通信用の HTTP エンドポイントを処理します。
環境構成: .envファイルを使用して簡単に構成できます。
TypeScript サポート: 開発者エクスペリエンスを向上させる、完全に型付けされたコードベース。

前提条件

始める前に、以下がインストールされていることを確認してください。

Node.js (v16 以上) -ここからダウンロード
npm （Node.jsに付属）またはyarn

はじめる

プロジェクトをセットアップして実行するには、次の手順に従います。

1. リポジトリのクローンを作成する

まだ行っていない場合は、リポジトリをローカルマシンにクローンします。

git clone https://github.com/your-username/hello-world-mcp-server.git cd hello-world-mcp-server

2. 依存関係をインストールする

npm または yarn を使用して必要な依存関係をインストールします。

npm install

または

yarn install

3. 環境変数を設定する

このプロジェクトでは、サーバーのポートを設定するために.envファイルを使用します。サンプルの.env.exampleファイルが提供されています。

.env.exampleファイルを.envにコピーします。
cp .env.example .env
.envファイルを開き、必要に応じてPORT変数を更新します。デフォルトは4000です。
PORT=4000

4. プロジェクトをビルドする

TypeScript コードを JavaScript にコンパイルします。

npm run build

これにより、 distディレクトリにコンパイルされたファイルが生成されます。

5. サーバーを実行する

サーバーを本番モードで起動します。

npm start

あるいは、ライブリロードを使用した開発モードでは、次を使用します。

npm run dev

サーバーのテスト

1. MCPインスペクターの使用

MCP Inspectorは、MCPサーバーをテストおよび検査するためのツールです。ツールとプロンプトが正しく登録されているかどうかを確認できます。

次のコマンドを実行してサーバーを検査します。

npx @modelcontextprotocol/inspector ./dist/server.js

これにより、以下のようにサーバーに登録されているツ��ルとプロンプトをテストできる対話型インターフェイスが開きます。

Hello World MCP Server

プロジェクト構造

プロジェクト構造の概要は次のとおりです。

hello-world-mcp-server/ ├── src/ │ ├── server.ts # Main server entry point │ ├── modules/ │ │ ├── tools.ts # Registers MCP tools │ │ ├── prompts.ts # Registers MCP prompts │ │ └── transports.ts # Handles SSE and message endpoints ├── .env # Environment variables ├── .env.example # Example environment variables ├── package.json # Project metadata and scripts ├── tsconfig.json # TypeScript configuration └── README.md # Project documentation

トラブルシューティング

よくある問題

ポートがすでに使用されています: ポートが使用中であるというエラーが表示される場合は、 .envファイル内のPORT変数を更新します。
TypeScript エラー: すべての依存関係がインストールされており、正しい Node.js バージョンを使用していることを確認してください。

デバッグ

サーバーをデバッグするには、次のコマンドを使用します。

npm run dev

これにより、ライブリロードと詳細なログを備えたサーバーが起動します。

貢献

貢献を歓迎します！お気軽に問題を報告したり、プルリクエストを送信してください。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

モデルコンテキストプロトコル (MCP) SDK を実装し、サーバー送信イベントとメッセージ処理用のツールとエンドポイントを提供するデモサーバー。

Related MCP Servers

MCP-Guide
qpd-v
A
security
-
license
A
quality
A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
Last updated -
3
16
63
Apache 2.0
Echo MCP Server
piebro
A
security
-
license
A
quality
A simple server implementing the Model Context Protocol (MCP) that echoes messages back, designed for testing MCP clients.
Last updated -
1
2
MIT License
MCP Server
stelang
-
security
-
license
-
quality
An implementation of the Model Context Protocol (MCP) server that enables multiple clients to connect simultaneously and handles basic context management and messaging with an extendable architecture.
Last updated -
MIT License
FastMCP Dummy Server
WaiYanNyeinNaing
-
security
-
license
-
quality
A minimal example server implementing the Model Context Protocol, providing addition and multiplication tools for learning and experimentation with MCP clients.
Last updated -

View all related MCP servers