Firecrawl Simple MCP

🚀 FastMCP 速查手冊

FastMCP 是一個強大的工具，可用於創建和管理 MCP 服務，能高效處理客戶端請求，提供豐富的功能和靈活的配置選項。

🚀 快速開始

📦 安裝

你可以通過以下兩種方式安裝 FastMCP：

• 使用 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 的核心，用於管理能力和處理客戶端請求。

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'
});

💻 使用示例

基礎用法

創建一個簡單的 MCP 服務並定義一個能力：

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);

高級用法

定義自定義能力

server.addCapability('searchFiles', async (query) => {
    // 在此處實現文件搜索邏輯
    return { type: 'text', text: `Searching for files matching ${query}` };
});

事件監聽

// 監聽服務器事件
server.on('connection', () => {
    console.log('New client connected');
});

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

// 監聽會話事件
const session = await server.currentSession;
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

📚 詳細文檔

MCP 服務器 API

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

MCP 會話 API

• MCPSession.sendMessage(message): Promise<void>
• MCPSession.requestSampling(options): Promise<void>
• MCPSession.currentSession: Promise<MCPSession>

🤔 常見問題解答

如何與 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')
    };
});

📄 許可證

文檔中未提及相關許可證信息。