Autoeq Mcp

AutoEQ MCP サーバー

pip install autoeq-mcp

AI アシスタントがAutoEQのヘッドフォンイコライゼーションデータベースにアクセスできるようにする MCP（Model Context Protocol）サーバーです。パラメトリック EQ 設定、音の傾向分析、Harman 好みスコアを含む8,800 種類以上のヘッドフォンと IEMを利用できます。

한국어 README

できること

AI アシスタントに、次のようなことを尋ねられます。

• 「HD650 の EQ 設定を教えて」
• 「HE400se と HD600 を比較して」
• 「温かみのある音のオーバーイヤーヘッドフォンをおすすめして」
• 「Harman スコア上位の IEM はどれ？」

サーバーは、8 つの帯域にわたる周波数応答測定を自動的に分析し、各ヘッドフォンの音の傾向（ニュートラル、ウォーム、ブライト、ダーク、V 字型など）を分類します。

デモ

ボーカルへの適性分析を含むヘッドフォン比較

音の傾向から似た IEM を検索

ツール

ツール	説明
eq_search	名前、種類（オーバーイヤー／インイヤー／イヤーバッド）、音の傾向、測定ソースで検索します
eq_profile	EQ プロファイル全体を取得します。パラメトリック EQ、固定バンド EQ、視覚的なバーを使った帯域別分析を含みます
eq_compare	2 つのヘッドフォンをすべての周波数帯域にわたって並べて比較します
eq_recommend	好み（ニュートラル、ウォーム、ブライト、低音、ボーカル、楽しい音、分析的）に応じておすすめします
eq_ranking	Harman のヘッドフォン聴取者向け好みスコアのランキングを表示します
eq_targets	利用可能な 61 種類のターゲットカーブ（Harman、拡散音場など）を一覧表示します
eq_sync	AutoEQ GitHub から最新データを取得してデータベースを再構築します

出力例

# Sennheiser HD 650
- Source: oratory1990
- Type: over-ear
- Harman preference score: 84.0
- Sound signature: Neutral, Harman-like

## Per-band analysis (deviation from target, dB)
  Sub-bass (20-60Hz):   -3.2 dB [·······▓▓▓|··········] sub-bass lacking
  Bass (60-250Hz):      +0.8 dB [··········|··········] close to target
  Mid (500-1kHz):       -0.3 dB [··········|··········] close to target
  Presence (2k-4kHz):   +1.4 dB [··········|▓·········] detail emphasis
  Air (8k-20kHz):       -2.1 dB [········▓▓|··········] closed / lacking air

## Parametric EQ (Preamp: -6.5 dB)
  #  Type        Fc (Hz)      Q  Gain (dB)
  1  LowShelf        105   0.70       +6.5
  2  Peaking        1800   1.20       -2.3
  ...

インストール

Claude Code / Claude Desktop（stdio）

# Install
pip install autoeq-mcp

# Initial database sync (clones AutoEQ repo + builds SQLite DB, ~20s)
autoeq-mcp --sync

# Add to Claude Code
claude mcp add autoeq_mcp -- autoeq-mcp

Claude Desktop の場合は、設定ファイルに追加します。

{
  "mcpServers": {
    "autoeq": {
      "command": "autoeq-mcp"
    }
  }
}

SSE モード（リモート／複数クライアント）

# Start SSE server
AUTOEQ_MCP_PORT=3008 autoeq-mcp --sse

# With allowed hosts for DNS rebinding protection
AUTOEQ_MCP_ALLOWED_HOSTS="your-domain.com,localhost" autoeq-mcp --sse

ソースからインストール

git clone https://github.com/verIdyia/autoeq-mcp
cd autoeq-mcp
pip install -e .
autoeq-mcp --sync

設定

すべての設定は環境変数で行います。

変数	デフォルト	説明
AUTOEQ_DATA_DIR	~/.autoeq-mcp	リポジトリのクローンと SQLite DB の保存先ディレクトリ
AUTOEQ_MCP_PORT	3008	SSE サーバーのポート
AUTOEQ_MCP_HOST	0.0.0.0	SSE サーバーのホスト
AUTOEQ_MCP_ALLOWED_HOSTS	(なし)	SSE で許可するホスト（カンマ区切り）

データソース

ヘッドフォンのデータはすべて、Jaakko Pasanen によるAutoEQ（MIT License）から取得しています。

• ヘッドフォン／IEM プロファイル 8,800 件以上
• 測定ソース 22 種類（oratory1990、crinacle、Rtings など）
• ターゲットカーブ 61 種類（Harman 2018/2019、拡散音場など）
• Harman 好みスコア 2,300 件以上

データベースは AutoEQ GitHub リポジトリと同期します。更新するには、eq_sync または autoeq-mcp --sync を実行します。

サウンドシグネチャの仕組み

サーバーは、各ヘッドホンの周波数特性の誤差（ターゲットからの逸脱）を8つの帯域にわたって分析し、分類します。

シグネチャ	特徴
ニュートラル	すべての帯域がターゲットの±2 dB以内
ウォーム	低音が強調され、高音はフラットまたは抑えられている
ブライト	高音が強調され、低音はフラットまたは抑えられている
ダーク	高音が抑えられている
V字型	低音と高音が強調され、中音域が抑えられている
U字型	低音と高音が強調されている
低音重視	低音が大幅に強調されている（>3 dB）
中音域重視	中音域が強調され、低音と高音はフラット
Harman風	全体の平均偏差が1.5 dB未満

ライセンス

MIT — LICENSEを参照