arthur-ficial/apfel-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Apfel (Appleのデバイス上のLM) を Web に到達し、ローカル ファイルを読むことを可能にする 4 つの小さな MCP ツール: url-fetch (ページの読み込み), ddg-search (web search), search-and-fetch (search+read in one call), fs...
概要
apfel-mcp は、これらの能力を正確に追加し、他にはない4つの小さなツールです。 それぞれは、apfel の小さなコンテキストウィンドウ(事実の後には閉じられません)に合うように既に整形されている結果を返します。 MCP サーバー: --mcp で 1 つを apfel に添付し、必要に応じてモデルが呼び出します。 お問い合わせ 使用 - これは、単一の、トークン・チャップ・ツール・コールで、Webと回答に関する最も「何かを見る」ニーズをカバーしています。 - —Webページを取得し、読みやすさでメインの記事ボディを抽出し、きれいなマークダウンを返します。 デフォルト〜4000文字、ハードキャップ6000文字(〜1500トークン)。 SSRFガード: http/httpsのみ、プライベートネットワークブロックリスト、10秒タイムアウト、2 MBダウンロードキャップ。 - — DuckDuckGo Web検索、APIキーは必要ありません。 〜300トークンでトップ5の結果を返します。 — DuckDuckGoは公開検索APIを提供していないため、HTMLエンドポイントを使用します。 時々の破損を期待して下さい。 ddg-searchの洞窟を参照してください。 - — 化合物ツール:検索すると、トップNの結果を単一のツールコールで取得します.
概要（AI 翻訳）
apfel は Apple のデバイスモデルを実行します。インターネットにアクセスしたり、ファイルを自分で読み込むことはできません。 apfel-mcp は、これらの能力を正確に追加する 4 つの小さなツールで、他に何もありません。 各結果は、apfel の小さな 4096-token コンテキストウィンドウ (事実の後にtuncated) に収まるように既にトリミングされています。
MCP サーバー: [--mcp] で 1 つを apfel に添付し、必要なときにモデルが呼び出します。
#必要なツールは?
| お問い合わせ | お問い合わせ | 注意 |
お問い合わせ
| 特定ウェブページ | [apfel-mcp-url-fetch | URL | 記事のテキスト、広告の除去 |
| ウェブ検索 | [apfel-mcp-ddg-search | 検索結果 | 実験的(DuckDuckGo スクレープ) |
| ご質問・ご意見・ご要望・ご要望・ご要望・ご要望等ございましたら、お気軽にお問い合わせ下さい。 |
| ローカルテキストファイル | [apfel-mcp-fs | ファイルパス | 読み込み専用 | 書き込み・削除なし |
お問い合わせ [apfel-mcp-search-and-fetch - それは、単一の、トークン·チェップツールコールで、ほとんどの「Web上の何かを見て、答え」のニーズをカバーします。
4つのMCPの詳細
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
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