型定義されたツール、依存性の注入、認証、テスト、および Node、Vercel、Lambda、Workers へのデプロイを備えた TypeScript 製 MCP server を構築します。
別名 agentfront/frontmcp, @frontmcp/adapters, @frontmcp/auth, @frontmcp/edge, @frontmcp/guard
- スター
- 152
- ツール
- —
- ダウンロード数(30日間)
- 220,205
- 最新バージョン
- —
- 最終コミット
- 2026年11月14日
- ライセンス
- Apache-2.0
FrontMCP MCPとは
FrontMCPはMCPサーバーです。 型定義されたツール、依存性の注入、認証、テスト、および Node、Vercel、Lambda、Workers へのデプロイを備えた TypeScript 製 MCP server を構築します。.
プロジェクトのREADMEから生成された概要
FrontMCP MCP server について
本フレームワークの主な機能は、プロダクション環境に対応した TypeScript 製 MCP server を構築することです。開発者は、型付きクラスと Zod スキーマを使用してツール、リソース、プロンプトを定義でき、これらは Model Context Protocol を介して提供されます。システムは、依存性の注入、認証、実行フローなどの複雑な要件を処理し、同じコードを修正なしでローカルマシンまたはプロダクション環境で実行できるようにします。
開発者は、Node、Vercel、AWS Lambda、Cloudflare Workers を含むさまざまな環境にサーバーをデプロイできます。エコシステムには、OAuth、guard によるレート制限、構造化されたオブザーバビリティなどの高度な機能のための専用パッケージが含まれています。ステートレスな 2026-07-28 リビジョンとそれ以前のバージョンのプロトコルの両方をサポートしており、スケーラブルなエージェント向けツールを作成するための汎用性の高い選択肢となります。
できること
- 1新しいプロジェクトの雛形作成開発者はコマンドラインインターフェースを使用して、新しい MCP server プロジェクトを迅速に初期化できます。
- 2型付きツールの作成TypeScript クラスと入力バリデーション用の Zod を使用して、数学的または論理的なツールを定義できます。
- 3エッジ関数へのデプロイ本フレームワークにより、Cloudflare Workers のような軽量なエッジ環境でサーバーを実行できます。
- 4人間による承認の実装開発者は、ツールの実行前に人間による承認を必要とするゲートを追加できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
FrontMCP MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにFrontMCP MCPをインストール
$ claude mcp add frontmcp -- npx -y @frontmcp/adaptersCursorにFrontMCP MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"frontmcp": {
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}VS CodeにFrontMCP MCPをインストール
.vscode/mcp.json
{
"servers": {
"frontmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}VS Code CLIにFrontMCP MCPをインストール
$ code --add-mcp '{"name":"frontmcp","type":"stdio","command":"npx","args":["-y","@frontmcp/adapters"]}'Claude DesktopにFrontMCP MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"frontmcp": {
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}CodexにFrontMCP MCPをインストール
$ codex mcp add frontmcp -- npx -y @frontmcp/adaptersCodex config.tomlにFrontMCP MCPをインストール
~/.codex/config.toml
[mcp_servers.frontmcp] command = "npx" args = ["-y", "@frontmcp/adapters"]
Gemini CLIにFrontMCP MCPをインストール
$ gemini mcp add -s user frontmcp npx -- -y @frontmcp/adaptersGemini settings.jsonにFrontMCP MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"frontmcp": {
"command": "npx",
"args": [
"-y",
"@frontmcp/adapters"
]
}
}
}自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
README
GitHubで見るfrontmcp.dev · Learn · Reference · Examples · Playground · Compare · Blog
FrontMCP is the TypeScript framework for MCP servers. You write tools, resources and prompts as typed classes with Zod schemas, and FrontMCP serves them over the Model Context Protocol, with dependency injection, authentication, testing, agents and jobs, on Node, Vercel, AWS Lambda and Cloudflare Workers. It serves MCP 2026-07-28, the stateless revision, and the earlier ones. The docs, examples and a browser playground are at frontmcp.dev.
Write a tool. Ship a server.
Classes in, protocol out. FrontMCP handles transport, DI, sessions, auth and execution flow, and the same server runs locally and in production unchanged.
import 'reflect-metadata';
import { App, FrontMcp, Tool, ToolContext, z } from '@frontmcp/sdk';
@Tool({
name: 'add',
description: 'Adds two numbers together',
inputSchema: { a: z.number(), b: z.number() },
})
class AddTool extends ToolContext {
async execute(input: { a: number; b: number }) {
return input.a + input.b;
}
}
@App({ id: 'calc', name: 'Calculator', tools: [AddTool] })
class CalcApp {}
@FrontMcp({
info: { name: 'Demo', version: '0.1.0' },
apps: [CalcApp],
http: { port: 3000 },
})
export default class Server {}
Start
npx frontmcp create my-app # new project (Node 24+)
npx frontmcp init # or add FrontMCP to an existing one
Then follow Learn on frontmcp.dev, or browse Tools, Resources, Prompts, Agents, Auth, Plugins, Tool UI, Testing and Deployment. Try it live in the Playground.
How it compares
TypeScript MCP server frameworks for production puts FrontMCP next to the official TypeScript SDK, FastMCP for TypeScript, Prefect's FastMCP TypeScript, mcp-framework, mcp-use, ViteMCP and xmcp, on auth, testing, protocol support and deployment. Each library's hello world was run and asked which MCP revisions it serves. Why FrontMCP says when the official SDK alone is enough, and The Best TypeScript MCP Server Frameworks in 2026 sums up the field. Moving a server over? See Migrate from the TypeScript SDK and Migrate from FastMCP.
Packages
Install frontmcp (CLI) and @frontmcp/sdk. The rest is pulled in for you, or opt-in. Keep every @frontmcp/* package on the same version: they depend on each other at exact versions.
| Package | What it does |
|---|---|
frontmcp |
CLI: create, init, dev, build, test, inspector |
@frontmcp/sdk |
Core framework: decorators, DI, flows, transport, MCP protocol |
@frontmcp/auth |
OAuth, JWKS, DCR/CIMD, sessions, credential vault |
@frontmcp/testing |
E2E test framework with fixtures and matchers |
@frontmcp/adapters |
Generate tools from an OpenAPI spec |
@frontmcp/skills |
Curated SKILL.md catalog for scaffolding and skills install |
@frontmcp/guard |
Rate limits, concurrency and policy guards |
@frontmcp/observability |
Structured logging, metrics and tracing |
@frontmcp/react |
React hooks and client for a FrontMCP server |
@frontmcp/ui / uipack |
Widgets, SSR renderers, MCP Bridge, themes |
@frontmcp/edge |
Run a server on Cloudflare Workers / V8 isolates |
@frontmcp/storage-sqlite |
SQLite session, task and elicitation stores |
@frontmcp/nx |
Nx generators and executors |
Internal, published so the above resolve: protocol, di, utils, lazy-zod.
| Package | What it does |
|---|---|
@frontmcp/plugin-cache |
Cache tool results with a TTL |
@frontmcp/plugin-remember |
Per-session memory (this.remember) |
@frontmcp/plugin-result-handles |
Fold large answers into a handle to query |
@frontmcp/plugin-approval |
Human approval gates before a tool runs |
@frontmcp/plugin-codecall |
Let the model compose tool calls as code |
@frontmcp/plugin-dashboard |
Built-in web dashboard |
@frontmcp/plugin-feature-flags |
Toggle tools and apps at runtime |
@frontmcp/plugin-skilled-openapi |
OpenAPI to skills and meta-tools for big APIs |
@frontmcp/plugin-webmcp |
Expose in-page tools to browser agents (WebMCP) |
PRs welcome: see CONTRIBUTING. Released under the Apache-2.0 license.
FrontMCP MCPのよくある質問
FrontMCP MCPをClaude Codeに追加するには
ターミナルでclaude mcp add frontmcp -- npx -y @frontmcp/adaptersを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
FrontMCP MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
FrontMCP とは何ですか?
FrontMCP は、MCP server を構築するための TypeScript フレームワークです。Zod スキーマを使用した型付きクラスとしてツール、リソース、プロンプトを定義でき、FrontMCP はそれらを Model Context Protocol を介して提供します。
新しい FrontMCP プロジェクトを作成するにはどうすればよいですか?
npx frontmcp create my-app を実行して新しいプロジェクトの雛形を作成するか、既存のプロジェクトに FrontMCP を追加するには npx frontmcp init を実行します。Node 24 以降が必要です。
FrontMCP server はどこにデプロイできますか?
同じサーバーが Node.js、Vercel、AWS Lambda、Cloudflare Workers 上で動作します。edge パッケージは Cloudflare Workers と V8 isolates をサポートしています。
FrontMCP は認証をサポートしていますか?
はい。@frontmcp/auth パッケージにより、OAuth、JWKS、DCR/CIMD、セッション、およびクレデンシャルボルトが提供されます。
FrontMCP server をテストすることはできますか?
はい、@frontmcp/testing がフィクスチャとマッチャーを備えたエンドツーエンドのテストフレームワークを提供しており、CLI には test コマンドが含まれています。