mcpField
M
MCP Server

MCP Server

ローカル
github.com/lincolnlopes開発ツール077 週間前に更新
リポジトリ

MCP Server について

Node.js、TypeScript、Express、公式MCP SDKを使ったMCPサーバープロジェクトです。ローカルHTTPエンドポイントと、起動・検査の手順を提供します。

主な機能

  1. 01Node.jsとTypeScriptによる実装
  2. 02Expressベースのサーバー
  3. 03/mcpエンドポイント
  4. 04ビルド・起動スクリプト
  5. 05MCP Inspectorのテスト手順

活用シーン

  1. 01開発中にローカルMCPサーバーを起動
  2. 02TypeScriptプロジェクトのビルド
  3. 03HTTP経由でMCPリクエストやツールを検査

MCP 対応

MCPリクエストを受け付けるPOST /mcpエンドポイントを実装しています。外部のMCP Inspectorへの接続方法もREADMEで説明されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "lincolnlopes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
起動コマンドnpx -y @modelcontextprotocol/inspector

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@modelcontextprotocol/inspector

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

MCP サーバー

このプロジェクトは、Node.js と TypeScript で実装された MCP（Model Context Protocol）サーバーです。

実行方法

  1. 依存関係をインストールします： 
    npm install
  2. プロジェクトをビルドします： 
    npm run build
  3. サーバーを起動します： 
    npm start

サーバーは http://localhost:3000/ で利用できます。

主なエンドポイント

  • POST /mcp：MCP リクエストのメインエンドポイントです。
  • GET /：サーバーのステータスメッセージです。

開発

  • ソースコードは src/ にあります。
  • 生成されたビルド成果物は dist/ に出力されます。
  • サーバーでは、Express と Model Context Protocol の公式 SDK を使用しています。

検査ツール

MCP サーバーのテストと検査には、MCP Inspector 公式版を使用してください。

MCP Inspector の使い方

MCP Inspector は、MCP サーバーに組み込まれて動作するものではありません。Postman や Insomnia と同様、HTTP 経由で MCP エンドポイントに接続する外部ツールですが、MCP プロトコルをネイティブにサポートしています。

オプション 1：公式サイトを使用する
  • https://inspector.modelcontextprotocol.org/ にアクセスします。
  • 接続フィールドに、サーバーのエンドポイントを入力します。例：http://localhost:3000/mcp
  • 接続をクリックすると、ビジュアルインターフェースにアクセスできます。
オプション 2：ローカルで実行する
  • ターミナルで実行します： 
    npx @modelcontextprotocol/inspector http://localhost:3000/mcp
  • ブラウザーで Inspector のインターフェースが開きます（通常は http://localhost:6274）。
注意事項
  • Inspector は常に外部クライアントであり、サーバーのプラグインではありません。
  • ブラウザーから /mcp に直接アクセスしないでください。ブラウザーは GET を実行しますが、このエンドポイントは POST を想定しています。
  • Inspector は POST リクエストを正しく送信し、すべての内容を使いやすいインターフェースに表示します。
  • リモートサーバーで実行している場合は、ファイアウォールでポート 3000 を開放してください。

修正と詳細情報

問題と適用された修正の詳細については、fixes/ フォルダーを参照してください。特に、ErrorCode の事例とその解決方法については、fixes/20250505-errorcode.md をご覧ください。

公式ドキュメント（代替）

詳細については、公式ドキュメントを参照してください（英語ですが、ブラウザーの自動翻訳を利用できます）。

または、Google Chrome の自動翻訳、あるいは翻訳版のこのリンクを利用して、ポルトガル語のドキュメントにアクセスしてください。

出典と参考資料

著者について

Lincoln Lopes（GitHub: lincolnlopes）

  • ブラジル出身の開発者
  • メール：[email protected]
  • 主なスキル：TypeScript、JavaScript、Node.js、.NET、Docker、React、SQL、Git

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。