Firecrawl Simple MCP

🚀 FastMCP 速查マニュアル

FastMCP は、MCP サーバーを迅速に構築するためのツールです。このマニュアルでは、FastMCP の基本的な使い方や高度な機能、API などを説明します。

🚀 クイックスタート

📦 インストール

npm を使用してインストールするには、以下のコマンドを実行します。

npm install fastmcp

または、yarn を使用する場合は、以下のコマンドを実行します。

yarn add fastmcp

💻 MCP サーバーの作成

新しい TypeScript ファイル（例：index.ts）を作成し、以下のコードを追加します。

import { createMCPServer } from 'fastmcp';

async function main() {
    const server = await createMCPServer();

    // 簡単な機能を定義：現在のディレクトリの内容を返す
    server.addCapability('ls', async () => {
        return {
            type: 'text',
            text: process.cwd()
        };
    });

    await server.start();
}

main().catch(console.error);

▶️ 実行

以下のコマンドを使用してサービスを実行します。

node index.ts

✨ 主な機能

🔧 コアコンセプト

MCP サーバー

MCPServer は FastMCP のコアで、機能の管理とクライアントからのリクエストの処理を行います。

• MCP サーバーの作成

import { createMCPServer } from 'fastmcp';

async function main() {
    const server = await createMCPServer();
    // ...
}

• 機能の定義 addCapability メソッドを使用してサーバーの機能を定義します。

server.addCapability('my_capability', async () => {
    return { type: 'text', text: 'Hello, World!' };
});

• サーバーの起動 start メソッドを呼び出して MCP サーバーを起動します。

await server.start();

セッション管理

接続された各クライアントには MCPSession インスタンスが作成されます。

• 現在のセッションの取得 以下の方法で現在のセッションを取得できます。

const session = await server.currentSession;

• メッセージの送信 sendMessage メソッドを使用してクライアントにメッセージを送信します。

await session.sendMessage({
    role: 'assistant',
    content: { type: 'text', text: 'Hello, World!' }
});

サンプリングリクエスト

MCP は requestSampling メソッドを提供してサンプリングリクエストを行います。

await session.requestSampling({
    messages: [
        {
            role: 'user',
            content: { type: 'text', text: 'What files are in the current directory?' }
        }
    ],
    systemPrompt: 'You are a helpful file system assistant.',
    includeContext: 'thisServer'
});

🌟 高度な機能

機能の定義

addCapability メソッドを使用して、サーバーにカスタム機能を追加できます。

server.addCapability('searchFiles', async (query) => {
    // ここにファイル検索ロジックを実装
    return { type: 'text', text: `Searching for files matching ${query}` };
});

イベント監視

MCP は豊富なイベント監視機能を提供しており、ページ上の様々なイベントを監視できます。

• サーバーイベントの監視

server.on('connection', () => {
    console.log('New client connected');
});

server.on('disconnection', () => {
    console.log('Client disconnected');
});

• セッションイベントの監視

session.on('message', (message) => {
    console.log('Received message:', message);
});

session.on('error', (error) => {
    console.error('Session error:', error);
});

⚙️ 設定オプション

起動設定

構成オブジェクトを渡すことで、サーバーの起動動作をカスタマイズできます。

await createMCPServer({
    port: 3000,
    host: 'localhost',
    capabilities: {
        my_capability: () => ({
            type: 'text',
            text: 'Hello, World!'
        })
    }
});

セッション設定

セッション設定を使用して、クライアントの特定の動作を調整できます。

session.setClientCapabilities({
    experimentalFeatures: true,
    loggingLevel: 'debug'
});

🛠️ ツールとリソース

MCP CLI

fastmcp dev コマンドを使用して開発サーバーを迅速に起動できます。

npx fastmcp dev server.js
npx fastmcp dev server.ts

MCP モニター

公式の MCP モニター を使用して、Web UI を通じてサーバーを確認できます。

npx fastmcp inspect server.ts

❓ よくある質問

Claude Desktop と連携するにはどうすればいいですか？

こちら のガイドに従って操作し、以下の設定を追加してください。

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "node",
      "args": ["index.js"]
    }
  }
}

カスタムプロトコルを処理するにはどうすればいいですか？

FastMCP は現在、標準の MCP プロトコルをサポートしており、カスタムプロトコルはサポートしていません。後続のバージョンの更新をお待ちください。

📚 チュートリアルとサンプル

シンプルなファイルマネージャー

基本的なファイル管理機能を作成します。

server.addCapability('listFiles', async () => {
    const files = await fs.promises.readdir('.');
    return {
        type: 'text',
        text: files.join('\n')
    };
});

📖 参考ドキュメント

MCP サーバー API

• createMCPServer([config]): Promise<MCPServer>
• MCPServer.start(): Promise<void>
• MCPServer.addCapability(name, callback): void
• MCPServer.on(event, listener): void

MCP セッション API

• （原文では不完全だったため、そのまま残します）MCPSession 関連の API も提供されていますが、原文で記載が不完全です。詳細は公式ドキュメントを参照してください。