🚀 MCP Server Fichador
MCP（模型上下文协议）服务器，用于在todamateria.com.br网站上搜索教育文章，并自动创建阅读卡片。
✨ 主要特性
本MCP服务器提供三个主要工具：
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（字符串，可选）：用于生成卡片的自定义提示
返回： 完整的阅读卡片，包含摘要、关键词、要点等。
📦 安装指南
- 克隆或下载服务器文件
- 安装依赖项：
npm install
- 编译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
基础用法
搜索关于物理的文章：
{
"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/"
}
}
📚 详细文档
阅读卡片的结构
每个阅读卡片包含：
interface FichaLeitura {
titulo: string; // 文章标题
resumo: string; // 内容摘要
palavrasChave: string[]; // 提取的关键词
temaPrincipal: string; // 文章的主要主题
pontosPrincipais: string[]; // 内容的要点
url: string; // 原始文章的URL
autor: string; // 文章作者
citacao: string; // 格式化的引用
}
生成的文件
当在criar_fichas_leitura函数中使用salvar: true时，卡片将保存到：
dados/fichas-leitura-{termo_busca}.json
局限性
- 仅适用于todamateria.com.br网站
- 卡片生成使用了简化的实现（可以与人工智能API集成以提高质量）
- 依赖于网站的HTML结构（如果网站更改，可能会失效）
贡献
欢迎贡献改进、修复或新功能！
📄 许可证
MIT