smithery-ai-cookbook-ts-smithery-cli について
公式の MCP TypeScript SDK と @smithery/cli で構築されたシンプルな MCP サーバーの例です。Smithery でストリーミング可能な HTTP サーバーをホストしたい開発者が対象で、互換性のため STDIO にも対応しています。
主な機能
- 01@smithery/cli によるサーバーのコンパイルとプレイグラウンドの起動
- 02Smithery 経由で渡されるセッション設定の処理
- 03環境変数による STDIO と HTTP トランスポートの切り替え
- 04smithery.yaml によるデプロイ設定
活用シーン
- 01TypeScript 製 MCP サーバーを Smithery にデプロイする方法の学習
- 02HTTP モードでのローカル開発とプレイグラウンドでのツール検証
- 03既存クライアント向けに STDIO モードでサーバーを実行
MCP 対応
本プロジェクトは MCP サーバーであり、src/index.ts で MCP ツールを公開し、Smithery から渡されるセッション設定を処理します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcpclaude mcp add --transport http ai-smithery-smithery-ai-cookbook-ts-smithery-cli https://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcp{"mcpServers":{"ai-smithery-smithery-ai-cookbook-ts-smithery-cli":{"type":"http","url":"https://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcp"}}}Cursor で開く{"servers":{"ai-smithery-smithery-ai-cookbook-ts-smithery-cli":{"type":"http","url":"https://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcp"}}}VS Code で開く{"mcpServers":{"ai-smithery-smithery-ai-cookbook-ts-smithery-cli":{"type":"http","url":"https://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcp"}}}{"mcpServers":{"ai-smithery-smithery-ai-cookbook-ts-smithery-cli":{"serverUrl":"https://server.smithery.ai/@smithery-ai/cookbook-ts-smithery-cli/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://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 CLI:
@smithery/cliを使用してサーバーをコンパイルし、インタラクティブなプレイグラウンドを起動します - Smithery セッション設定:Smithery 経由で渡されるユーザーのセッション設定を処理します
- HTTP トランスポート:TRANSPORT 環境変数を使用して、STDIO と HTTP の両方のトランスポートで実行できます
前提条件
- Node.js 22 以降
- npm パッケージマネージャー
プロジェクト構成
src/index.ts- MCP ツールとセッション設定を含む、サーバーのメイン実装package.json- Node.js の依存関係とスクリプトsmithery.yaml- Smithery のデプロイ設定
クイックスタート
-
依存関係をインストールする:
npm install -
開発サーバーを実行する:
HTTP モード(インタラクティブなテスト用に Smithery プレイグラウンドを自動的に起動します):
npm run dev
任意 - STDIO モード: STDIO モードで実行する場合は、次のコマンドを使用できます:
API_KEY=your-api-key npm run start:stdio -
独自のバージョンをデプロイする: 独自の MCP サーバーをデプロイするには:
- https://smithery.ai/new でリポジトリを接続します
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。