arthur-ficial/apfel-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Четыре небольших инструмента MCP, которые позволяют apfel (Apple's on-device LLM) достичь сети и читать локальные файлы: url-fetch (читать страницу), ddg-search (веб-поиск), search-and-fetch (поиск + чтение в одном вызове), fs...
Обзор
apfel-mcp - это четыре небольших инструмента, которые добавляют именно эти способности. Каждый из них возвращает результат, уже подстриженный под крошечное контекстное окно Apfel (не усеченное после факта). Это MCP-серверы: вы прикрепляете один к apfel с -mcp, и модель вызывает его, когда это необходимо. Не уверен? Используйте - это охватывает большинство потребностей «посмотреть что-то в Интернете и ответить» в одном дешевом инструменте. — — получить веб-страницу, извлечь основной корпус статьи через Readability, вернуть чистую разметку. По умолчанию ~4000 загонов, жесткий заголовок 6000 загонов (~1500 токенов). Охранники SSRF: только http / https, блок-лист частной сети, 10-секундный тайм-аут, ограничение загрузки 2 МБ. DuckDuckGo веб-поиск, ключ API не требуется. Возвращает топ-5 результатов в ~300 токенов. DuckDuckGo не предоставляет API для публичного поиска, поэтому он использует конечную точку HTML. Ожидайте случайных поломок. См. ddg-search caveats. Сложный инструмент: поиск, а затем получение лучших результатов N в одном вызове инструмента.
Обзор (машинный перевод)
**apfel работает по модели Apple on-device — он не может самостоятельно добраться до интернета или прочитать ваши файлы. ** apfel-mcp — это четыре небольших инструмента, которые добавляют именно эти способности, и ничего больше. Каждый из них возвращает результат, уже подстриженный под крошечное окно контекста apfel 4096-токен (не усеченное после факта).
Они являются MCP-серверами: вы прикрепляете один к apfel с --mcp, и модель вызывает его, когда это необходимо.
Какой инструмент мне нужен?
Вы хотите… использовать Вы даете его | Примечание
[скрыто] [скрыто] [скрыто] [скрыто]
| Прочитайте конкретную веб-страницу | apfel-mcp-url-fetch | URL | текст статьи, объявления обрезаны |
| Поиск в Интернете | apfel-mcp-ddg-search | поисковый запрос | экспериментальный (DuckDuckGo scrape) |
Задайте вопрос, который нуждается в Интернете | apfel-mcp-search-and-fetch | вопрос | поиск ** и ** читает, в один звонок - начните здесь |
| Читать локальный текстовый файл | apfel-mcp-fs | путь файла | только для чтения, без записи / удаления |
Не уверен? Используйте apfel-mcp-search-and-fetch — он охватывает большинство потребностей «поищите что-то в Интернете и отвечайте» в одном дешевом инструменте.
##Четыре MCP, в деталях
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
apfel-mcp
apfel runs Apple’s on-device model - it cannot reach the internet or read your files on its own. apfel-mcp is four small tools that add exactly those abilities, and nothing else. Each returns a result already trimmed to fit apfel’s tiny 4096-token context window (not truncated after the fact).
They are MCP servers: you attach one to apfel with --mcp, and the model calls it when it needs to.
Which tool do I need?
| You want to… | Use | You give it | Note |
|---|---|---|---|
| Read a specific web page | apfel-mcp-url-fetch |
a URL | article text, ads stripped |
| Search the web | apfel-mcp-ddg-search |
a search query | experimental (DuckDuckGo scrape) |
| Ask a question that needs the web | apfel-mcp-search-and-fetch |
a question | searches and reads, in one call - start here |
| Read a local text file | apfel-mcp-fs |
a file path | read-only, no writing/deleting |
Not sure? Use apfel-mcp-search-and-fetch - it covers most “look something up on the web and answer” needs in a single, token-cheap tool call.
The four MCPs, in detail
apfel-mcp-url-fetch— fetch a web page, extract the main article body via Readability, return clean markdown. Default ~4000 chars, hard cap 6000 chars (~1500 tokens). SSRF guards:http/httpsonly, private-network blocklist, 10-second timeout, 2 MB download cap.apfel-mcp-ddg-search— DuckDuckGo web search, no API key required. Returns top 5 results in ~300 tokens. Experimental, unofficial, scraping-based — DuckDuckGo does not provide a public search API, so this uses their HTML endpoint. Expect occasional breakage. See ddg-search caveats.apfel-mcp-search-and-fetch— compound tool: search then fetch the top N results in a single tool call. Saves ~500 tokens of tool-call schema and conversation overhead versus calling search + fetch separately. Hard cap 5000 chars (~1250 tokens).apfel-mcp-fs— read a bounded slice of a local text file. Read-only: it cannot write, move, or delete anything. Path allowlist viaAPFEL_MCP_FS_ROOTS(defaults to the working directory); paths outside the roots and binary files are refused. Default ~4000 chars, hard cap 6000 chars. See fs caveats.
Why a separate repo
Установка
npx @modelcontextprotocol/inspector python -m apfel_mcp.url_fetch_server