Averra Extract Mcp について
Averra Extract MCP Serverは、AIクライアントをAverra Extractに接続し、ウェブページをメタデータ付きの整形済みMarkdownに変換します。利用状況の確認やAPIキー管理も行えます。
主な機能
- 01URLをMarkdownに変換
- 02ページのメタデータを付加
- 03月間利用枠の確認
- 04APIキーの作成と一覧表示
- 05APIキーの取り消し
活用シーン
- 01AIワークフロー向けのウェブ内容の準備
- 02月間の残りリクエスト数の確認
- 03アカウントのAPIキー管理
MCP 対応
URL変換、利用枠の確認、APIキー管理など、Averra Extract APIの5つの操作をMCPツールとして公開します。stdioとHTTPのトランスポートに対応しています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
5掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | はい | コンテンツを抽出する Web ページの URL。完全な URL(`https://example.com`)またはホスト名のみ(`example.com` — `https://` を自動付加)を指定できます。最大 2048 文字。プライベート/内部 IP は API によってブロックされます。 |
| response_format | enum | いいえ | 出力形式:人間が読みやすい出力には 'markdown'(デフォルト)、機械可読の構造化データには 'json'markdown | json |
詳細
Averra Extract MCP サーバー
Averra Extract 用の MCP(Model Context Protocol)サーバーです。Claude、Cursor、ChatGPT などの AI エージェントが、あらゆるウェブページをクリーンで LLM に適した Markdown に変換できます。
公式の MCP レジストリに dev.averra/extract として登録されています。 レジストリ経由のインストールに対応する MCP クライアントでは、この識別子を直接参照できます。手動設定が必要なクライアントについては、以下のインストール手順をご覧ください。
できること
Averra Extract API を 5 つの MCP ツールとして公開します。
| ツール | 説明 |
|---|---|
averra_extract_url | 任意の URL をメタデータ付きのクリーンな Markdown に変換します |
averra_check_usage | 月間利用枠と残りのリクエスト数を確認します |
averra_create_api_key | 新しい API キーを作成します |
averra_list_api_keys | アカウントに登録されているすべての API キーを一覧表示します |
averra_revoke_api_key | ID を指定して API キーを無効化します |
API キーを取得する
averra.dev でサインアップしてください。無料プランでは月 50 件のリクエストを利用できます。
インストール(Claude Desktop)
claude_desktop_config.json に以下を追加してください。
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"averra-extract": {
"command": "npx",
"args": ["-y", "@averra/extract-mcp"],
"env": {
"AVERRA_EXTRACT_API_KEY": "sk_live_your_key_here"
}
}
}
}
Claude Desktop を再起動してください。セッションに 5 つのツールが表示されます。
インストール(Cursor)
~/.cursor/mcp.json に追加してください(または Cursor の MCP 設定 UI を使用してください)。
{
"mcpServers": {
"averra-extract": {
"command": "npx",
"args": ["-y", "@averra/extract-mcp"],
"env": {
"AVERRA_EXTRACT_API_KEY": "sk_live_your_key_here"
}
}
}
}
インストール(その他の MCP クライアント)
stdio ベースの MCP クライアントであればどれでも使用できます。環境変数に AVERRA_EXTRACT_API_KEY を設定し、npx -y @averra/extract-mcp を指定してください。
設定
| 環境変数 | 必須 | デフォルト | 説明 |
|---|---|---|---|
AVERRA_EXTRACT_API_KEY | はい | — | Extract API キー(sk_live_ で始まります) |
AVERRA_EXTRACT_BASE_URL | いいえ | https://averra.dev | API ホストを上書きします |
TRANSPORT | いいえ | stdio | stdio(ローカル)または http(ホスト型) |
PORT | いいえ | 3000 | TRANSPORT=http の場合のポート |
プロンプトの例(Claude Desktop)
インストール後、次のように試してみてください。
- 「https://example.com のコンテンツを抽出して要約してください」
- 「今月の Extract の残り利用枠はいくつですか?」
- 「https://docs.anthropic.com/en/docs/intro を読んで、重要な概念を教えてください」
- 「Extract API キーを一覧表示してください」
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。