Fastmcp

🚀 FastMCP 快速入門ガイド

FastMCPは、MCP（モデルコンテキストプロトコル）サーバーを迅速に開発するためのTypeScriptフレームワークです。様々なLLMとの統合を簡素化し、複数の高度な機能をサポートしています。

🚀 クイックスタート

インストール

FastMCPを使用するには、以下の手順でインストールしてください。

1. npmを使用してFastMCPをインストールします。

npm install fastmcp --save

2. server.tsという名前の新しいファイルを作成し、以下のコードを追加します。

import { createServer } from 'fastmcp';

const server = createServer();

// カスタムルートを追加
server.get('/ping', (req, res) => {
  res.send('pong');
});

server.start(3000);

3. サーバーを起動します。

ts-node server.ts

基本的な使い方

以下は、基本的なMCPサーバーを作成する簡単な例です。

import { createServer } from 'fastmcp';

const server = createServer();

// ルートパスのリクエストを処理
server.get('/', (req, res) => {
  res.send('Welcome to FastMCP Server!');
});

// サーバーを起動
server.start(3000);

✨ 主な機能

• 使いやすさ：直感的なAPIとミドルウェアシステムを通じて、カスタムMCPサービスを迅速に構築できます。
• 高性能：組み込みの効率的なリクエスト処理メカニズムにより、低遅延と高スループットを保証します。
• 拡張性：プラグインシステムをサポートし、カスタム機能を簡単に追加できます。
• クロスプラットフォーム互換性：複数のオペレーティングシステムと環境をサポートします。

💻 使用例

基本的な使用法

import { createServer } from 'fastmcp';

const server = createServer();

// ルートパスのリクエストを処理
server.get('/', (req, res) => {
  res.send('Welcome to FastMCP Server!');
});

// サーバーを起動
server.start(3000);

高度な使用法

ミドルウェアの使用例

import { createServer, Middleware } from 'fastmcp';

const server = createServer();

// 簡単なミドルウェアを作成
const loggerMiddleware: Middleware = (req, res, next) => {
  console.log('请求开始:', req.url);
  next();
};

// ミドルウェアをすべてのリクエストに適用
server.use(loggerMiddleware);

server.get('/', (req, res) => {
  res.send('Hello World!');
});

server.start(3000);

ルートの使用例

import { createServer } from 'fastmcp';

const server = createServer();

// 異なるリクエストタイプを処理するルートを定義
server.get('/api/data', (req, res) => {
  // JSONデータを返す
  res.json({ message: '数据获取成功!' });
});

server.post('/api/upload', async (req, res) => {
  // ファイルアップロードを処理
  const uploadedFile = await req.file();
  res.send(`文件 ${uploadedFile.name} 成功上传！`);
});

server.start(3001);

📚 ドキュメント

設定オプション

FastMCPは、様々なニーズに対応するための豊富な設定オプションを提供しています。

ポート設定

server.start({
  port: 3001,
});

ログ記録

server.configure({
  loggingLevel: 'debug',
});

APIリファレンス

Server クラス

• start(port: number)：指定されたポートでサーバーを起動します。
• get(path: string, handler: (req, res) => void)：新しいGETルートを追加します。
• post(path: string, handler: (req, res) => void)：新しいPOSTルートを追加します。

Middleware

• 型定義：

type Middleware = (
  req: Request,
  res: Response,
  next: () => void
) => void;

開発ガイド

カスタムミドルウェアの作成

FastMCPでは、カスタムミドルウェアを作成してサーバー機能を拡張できます。

import { createServer, Middleware } from 'fastmcp';

const server = createServer();

// カスタムログ記録ミドルウェア
const logger: Middleware = (req, res, next) => {
  console.log(`收到请求：${req.method} ${req.url}`);
  next();
};

server.use(logger);

server.get('/', (req, res) => {
  res.send('Hello World!');
});

server.start(3002);

プラグインの使用

FastMCPのプラグインシステムを使用すると、サーバー機能を迅速に拡張できます。例えば、認証やログ記録などを追加できます。

import { createServer } from 'fastmcp';
import { cors } from 'fastmcp/plugins/cors';

const server = createServer();

// CORSプラグインを有効にする
server.use(cors());

server.get('/api/test', (req, res) => {
  res.send('CORS 已启用!');
});

server.start(3003);

一般的な質問

エラーをどのように処理するか？

ミドルウェアを使用してエラーをキャッチし、処理することができます。

import { createServer, Middleware } from 'fastmcp';

const server = createServer();

// エラー処理ミドルウェア
const errorHandler: Middleware = (req, res, next) => {
  try {
    next();
  } catch (err) {
    console.error('发生错误:', err);
    res.status(500).send('服务器内部错误');
  }
};

server.use(errorHandler);

server.get('/test/error', () => {
  throw new Error('测试错误处理');
});

server.start(3004);

📖 詳細なドキュメント

FastMCPには、詳細なドキュメントとサンプルが用意されており、素早く使い始めて高度な機能を習得するのに役立ちます。FastMCP公式ウェブサイトを訪問して、完全なドキュメントを確認してください。

その他のリソース

• GitHubリポジトリ：fastmcp/fastmcp
• Discordコミュニティ：FastMCPディスカッショングループに参加して、サポートを受けたり交流したりしてください。
• 開発者ブログ：FastMCP開発ログを読んで、最新の動向を把握してください。