mcpField
S
smithery-ai-cookbook-ts-smithery-cli

smithery-ai-cookbook-ts-smithery-cli

リモート
github.com/smithery-ai開発ツール2057 週間前に更新
リポジトリ

smithery-ai-cookbook-ts-smithery-cli について

公式の MCP TypeScript SDK と @smithery/cli で構築されたシンプルな MCP サーバーの例です。Smithery でストリーミング可能な HTTP サーバーをホストしたい開発者が対象で、互換性のため STDIO にも対応しています。

主な機能

  1. 01@smithery/cli によるサーバーのコンパイルとプレイグラウンドの起動
  2. 02Smithery 経由で渡されるセッション設定の処理
  3. 03環境変数による STDIO と HTTP トランスポートの切り替え
  4. 04smithery.yaml によるデプロイ設定

活用シーン

  1. 01TypeScript 製 MCP サーバーを Smithery にデプロイする方法の学習
  2. 02HTTP モードでのローカル開発とプレイグラウンドでのツール検証
  3. 03既存クライアント向けに STDIO モードでサーバーを実行

MCP 対応

本プロジェクトは MCP サーバーであり、src/index.ts で MCP ツールを公開し、Smithery から渡されるセッション設定を処理します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcp認証が必要

ツール

詳細

Smithery CLI を使用した TypeScript MCP サーバー

公式の MCP Typescript SDK と smithery/cli を使用して構築された、シンプルな TypeScript MCP サーバーです。このサンプルでは、smithery/cli を使用して Smithery 上でストリーミング可能な HTTP サーバーをホストする方法を紹介します。下位互換性のため、STDIO にも対応しています。

詳細なガイドはこちらをご覧ください:https://smithery.ai/docs/migrations/typescript-with-smithery-cli

Smithery で実際に試す

機能:

  • Smithery CLI:@smithery/cli を使用してサーバーをコンパイルし、インタラクティブなプレイグラウンドを起動します
  • Smithery セッション設定:Smithery 経由で渡されるユーザーのセッション設定を処理します
  • HTTP トランスポート:TRANSPORT 環境変数を使用して、STDIO と HTTP の両方のトランスポートで実行できます

前提条件

  • Node.js 22 以降
  • npm パッケージマネージャー

プロジェクト構成

  • src/index.ts - MCP ツールとセッション設定を含む、サーバーのメイン実装
  • package.json - Node.js の依存関係とスクリプト
  • smithery.yaml - Smithery のデプロイ設定

クイックスタート

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

    npm install
    
  2. 開発サーバーを実行する:

    HTTP モード(インタラクティブなテスト用に Smithery プレイグラウンドを自動的に起動します):

    npm run dev
    
    Smithery プレイグラウンド

    任意 - STDIO モード: STDIO モードで実行する場合は、次のコマンドを使用できます:

    API_KEY=your-api-key npm run start:stdio
    
  3. 独自のバージョンをデプロイする: 独自の MCP サーバーをデプロイするには:

コメント

MCP は初めてですか?

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

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