Mcpserverfichador

🚀 MCP Server Fichador

MCP（Model Context Protocol）サーバーで、todamateria.com.brサイトから教育記事を検索し、自動的に読書ノートを作成します。

✨ 主な機能

このMCPサーバーは、3つの主要なツールを提供します。

1. buscar_artigos

todamateria.com.brサイトで、検索用語に基づいて記事を検索します。

パラメーター:

• termo_busca (文字列、必須): 記事を検索するための用語
• todas_paginas (ブール値、オプション): すべてのページで検索するか、最初のページのみで検索するか（デフォルト: false）

戻り値: タイトルとURLを含む見つかった記事のリスト。

2. raspar_conteudo

サイトの特定のページから完全なコンテンツを抽出します。

パラメーター:

• url (文字列、必須): コンテンツを抽出するページのURL

戻り値: タイトル、テキスト、画像、著者、引用を含むページの完全なコンテンツ。

3. criar_fichas_leitura

記事を検索し、コンテンツを抽出し、構造化された読書ノートを作成する完全な関数です。

パラメーター:

• termo_busca (文字列、必須): 記事を検索するための用語
• todas_paginas (ブール値、オプション): すべてのページで検索するかどうか（デフォルト: false）
• salvar (ブール値、オプション): 読書ノートをJSONファイルに保存するかどうか（デフォルト: true）
• prompt_customizado (文字列、オプション): 読書ノートの生成に使用するカスタムプロンプト

戻り値: 要約、キーワード、主要ポイントなどを含む完全な読書ノート。

📦 インストール

1. サーバーのファイルをクローンまたはダウンロードします。
2. 依存関係をインストールします。

npm install

3. TypeScriptをコンパイルします。

npm run build

💻 使用例

スタンドアロンのMCPサーバーとして

npm start

Claude Desktopとの統合

Claude Desktopの設定ファイル (claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "fichador": {
      "command": "node",
      "args": ["/caminho/para/seu/projeto/dist/index.js"],
      "env": {}
    }
  }
}

開発用

開発モードで実行するには、以下を実行します。

npm run dev

📚 ドキュメント

読書ノートの構造

各読書ノートには以下が含まれます。

interface FichaLeitura {
  titulo: string;           // 記事のタイトル
  resumo: string;           // コンテンツの要約
  palavrasChave: string[];  // 抽出されたキーワード
  temaPrincipal: string;    // 記事の主要なテーマ
  pontosPrincipais: string[]; // コンテンツの主要ポイント
  url: string;              // 元の記事のURL
  autor: string;            // 記事の著者
  citacao: string;          // 整形された引用
}

具体的な使用例

物理学に関する記事を検索する

{
  "name": "buscar_artigos",
  "arguments": {
    "termo_busca": "física quântica",
    "todas_paginas": false
  }
}

数学に関する読書ノートを作成する

{
  "name": "criar_fichas_leitura",
  "arguments": {
    "termo_busca": "equações diferenciais",
    "todas_paginas": true,
    "salvar": true
  }
}

特定のページのコンテンツを抽出する

{
  "name": "raspar_conteudo",
  "arguments": {
    "url": "https://www.todamateria.com.br/fisica-quantica/"
  }
}

生成されるファイル

criar_fichas_leitura関数でsalvar: trueを使用すると、読書ノートは以下に保存されます。

dados/fichas-leitura-{termo_busca}.json

🔧 技術詳細

制限事項

• 特定のサイトtodamateria.com.brでのみ機能します。
• 読書ノートの生成には簡略化された実装が使用されており、AI APIと統合することで品質を向上させることができます。
• サイトのHTML構造に依存しているため、サイトが変更されると機能しなくなる可能性があります。

📄 ライセンス

MITライセンスの下で提供されています。

コントリビューション

改善点、修正点、新機能についてのコントリビューションはいつでも歓迎します！