
punkpeye/fastmcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCPサーバーを構築するためのTypeScriptフレームワークです。
概要
クライアントセッションを処理できるMCPサーバーを構築するためのTypeScriptフレームワークです。 Pythonの実装についてはFastMCPを参照してください。 FastMCPは公式SDKの上に構築されています。 公式SDKはMCP構築の基礎ブロックを提供しますが、多くの実装の詳細はあなたに委ねています。 - すべてのサーバーコンポーネントの開始および設定 - 接続の処理 - ツールの管理 - レスポンスの処理 - リソースの管理 - プロンプト、リソース、リソーステンプレートの追加 - リソース、画像および音声コンテンツブロックの埋め込み FastMCPは、意見を述べたフレームワークを提供することで、この複雑さを排除します。 - すべてのボイラープレートを自動的に処理 - 一般的なタスクに対してシンプルで直感的なAPIを提供する - 組み込みのベストプラクティスとエラー処理を含み - MCPのコア機能に集中できる 低レベルの実装の詳細にこだわらず、MCPサーバーを素早く構築したいのです。
概要(AI 翻訳)
クライアントセッションを処理できるMCPサーバーを構築するためのTypeScriptフレームワークです。
[!重要]
FastMCP>、レガシーのハンドシェイクベースのMCPリビジョン(2025-11-25およびそれ以前)を実装しています。現在の仕様2026-07-28をサポートしておらず、これによりプロトコルはステートレスとなり、initializeハンドシェイクもMcp-Session-Idもありません。現在の仕様を対象としたフレームワークにはViteMCPをご利用ください。
特徴
- シンプルツール、リソース、プロンプト定義
- OpenAPIからMCPへの変換
- 認証
- コンテキストを通じたヘッダーの渡し
- セッションIDおよびリクエストIDの追跡
- セッション
- 画像コンテンツ
- 音声コンテンツ
- 組み込み
- 伐学
- エラー処理
- HTTPストリーミング(SSE互換性)
- 安全な接続のためのHTTPSサポート
- REST API、ウェブフック、管理者インターフェース向けのカスタムHTTPルート
- Cloudflare Workers、Deno Deployなどのエッジランタイムサポート
- サーバーレス展開のためのステートレスモード
- CORS(デフォルトで有効)
- 進捗通知
- ストリーミング出力
- タイプ化されたサーバーイベント
- プロンプト引数自動補完
- サンプリング
- 引き出
- 設定可能なping動作
- ヘルスチェックエンドポイント
- ルーツ
- ポートをバインドせずにユニットテストのためのインメモリトランスポート
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
FastMCP
A TypeScript framework for building MCP servers capable of handling client sessions.
[!IMPORTANT]
FastMCP implements the legacy, handshake-based MCP revisions (
2025-11-25and earlier). It does not support the current specification,2026-07-28, which made the protocol stateless — noinitializehandshake and noMcp-Session-Id. For a framework targeting the current spec, use ViteMCP.
Features
- Simple Tool, Resource, Prompt definition
- OpenAPI to MCP conversion
- Authentication
- Passing headers through context
- Session ID and Request ID tracking
- Sessions
- Image content
- Audio content
- Embedded
- Logging
- Error handling
- HTTP Streaming (with SSE compatibility)
- HTTPS Support for secure connections
- Custom HTTP routes for REST APIs, webhooks, and admin interfaces
- Edge Runtime Support for Cloudflare Workers, Deno Deploy, and more
- Stateless mode for serverless deployments
- CORS (enabled by default)
- Progress notifications
- Streaming output
- Typed server events
- Prompt argument auto-completion
- Sampling
- Elicitation
- Configurable ping behavior
- Health-check endpoint
- Roots
- In-memory transport for unit testing without binding a port
- CLI for testing and debugging
When to use FastMCP over the official SDK?
FastMCP is built on top of the official SDK.
The official SDK provides foundational blocks for building MCPs, but leaves many implementation details to you:
- Initiating and configuring all the server components
- Handling of connections
- Handling of tools
- Handling of responses
- Handling of resources
インストール
npx tsx /PATH/TO/YOUR_PROJECT/src/index.ts設定
{
"mcpServers": {
"my-mcp-server": {
"command": "npx",
"args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
"env": {
"YOUR_ENV_VAR": "value"
}
}
}
}