matetools

@mate-tools/mcp-server

mate.tools 用の Model Context Protocol サーバーです。AI エージェント向けの 35 種類のユーティリティツールを提供します。テキスト分析、エンコード、ハッシュ生成、パスワード生成、JSON/CSV/XML/サイトマップの解析、正規表現、色、日付、金融、URL メタデータ抽出、SEO メタタグ生成、テキストのクリーンアップ、CSPRNG 乱数生成、ハッシュタグツール、DNS ルックアップ、SSL/TLS 証明書の検査、JWT のデコードなどに対応しています。公開されている mate.tools JSON API をラップしているため、Claude Desktop、Claude Code、Cursor、Windsurf、その他の MCP 対応クライアントから直接呼び出せます。

依存関係ゼロ · 無料 · API キー不要 · CORS オープン · Node 18 以上

クイックインストール

Claude Desktop / Claude Code / Cursor / Windsurf の設定に次を追加してください。

{
  "mcpServers": {
    "mate-tools": {
      "command": "npx",
      "args": ["-y", "@mate-tools/mcp-server"]
    }
  }
}

クライアントを再起動すると、35 種類すべてのツールがピッカーに表示されます。これで完了です。

カテゴリ別の全 35 種類のツール

テキスト（8）

ツール	機能
count_lines	16 種類のテキスト指標を測定します。行数、単語数、文数、段落数、文字数、重複、改行コード（LF/CRLF/CR）、最長単語、読了時間と発話時間に対応しています。
case_convert	1 回の呼び出しでテキストを 9 種類の大文字・小文字スタイルに変換します。大文字、小文字、タイトルケース、文頭大文字、スネークケース、ケバブケース、キャメルケース、パスカルケース、定数ケースに対応しています。
slugify	任意のテキストを URL で安全に使えるスラッグに変換します。Unicode に対応し、区切り文字と長さを設定でき、非ラテン文字の音訳も任意で行えます。
sort_lines	行を並べ替えます。昇順／降順、大文字・小文字の区別、重複除去、自然順ソート（line2 を line10 より前に配置）、ロケール対応の照合に対応しています。
lorem_ipsum	段落、文、単語のプレースホルダーテキストを生成します。
regex_test	PCRE 正規表現を使ってテキストを検索、置換、分割します。キャプチャグループのオフセットを返します。ReDoS から保護されています。
text_diff	2 つの文字列を行、単語、文字単位で比較します。構造化された変更内容、統合形式の差分文字列、ジャッカード類似度を返します。
text_cleanup	クリーンアップ処理を連結して実行します。前後の空白削除、連続するスペースの圧縮、重複行の削除、HTML／絵文字／URL／メールアドレスの除去、引用符／ダッシュの正規化、小文字／大文字への変換に対応しています。

エンコード（4）

ツール	機能
base64_encode	テキストを Base64 エンコードします。標準または URL セーフな文字セット（RFC 4648 §5）を選べます。
base64_decode	Base64 をデコードします。不足しているパディングは自動修正し、有効な UTF-8 でない場合は 16 進数で返します。
url_encode	文字列をパーセントエンコードします。コンポーネント／フォーム／パスのモードに対応しています。
url_decode	パーセントエンコードされた URL 文字列をデコードします。

暗号化と認証（5）

ツール	機能
hash	MD5、SHA-1、SHA-256、SHA-384、SHA-512、SHA3-256、SHA3-512、CRC32（または PHP のハッシュアルゴリズムの任意のサブセット）に対応しています。
password	暗号学的に安全な乱数パスワード（CSPRNG）を生成します。長さ、個数、文字種、紛らわしい文字の除外を設定できます。エントロピーも報告します。
password_strength	パスワードを 0～4 で評価し（zxcvbn 方式）、エントロピーのビット数、オフライン GPU による解読時間の推定、懸念点、提案を返します。
credit_card_validate	Luhn チェックとブランド判定（Visa、MC、Amex、Discover、JCB、Diners、UnionPay、Maestro、RuPay）を行います。PAN はログに記録されません。
jwt_decode	JWT をデコードし、ヘッダー、ペイロード、有効期限の状態を返します。シークレットを使った HS256/384/512、または PEM 公開鍵を使った RS256/384/512 の検証に対応しています。トークンはログに記録されません。

データと構造（13）

ツール	説明
json_format	JSON ドキュメントを検証、整形、最小化、または解析します。構造の概要（ノード数、最大深度、トップレベルのキー）を返します。
json_to_csv	JSON オブジェクト配列を CSV に変換します。区切り文字や列を設定でき、ネストされたオブジェクト（meta.city、meta.zip）のフラット化も任意で行えます。
xml_validate	XML の整形式性と、任意で XSD スキーマを検証します。エラーの行と列を示します。XXE 対策済みです。
sitemap_extract	XML サイトマップを取得して解析します。SSRF 対策済み（プライベート／ループバック／リンクローカル／クラウドメタデータの IP を拒否します）。サブサイトマップの再帰的な展開も任意で行えます。
stats	数値リストの記述統計を計算します。平均値／中央値／最頻値／標準偏差／分散／パーセンタイル／IQR／幾何平均／調和平均に対応します。
number_base	2～36 進数とローマ数字の間で整数を変換します。GMP による大きな整数にも安全に対応しています。
finance_calc	複数モードの金融計算に対応します。ローン、複利、単利、割引、チップ、売上税、ROI、パーセンテージ、マークアップを計算します。
aspect_ratio	幅 × 高さから縦横比（16:9、4:3、21:9 など）を約分して求めるか、目標の比率に合わせて寸法を調整します。
color_convert	任意の色を hex／rgb／rgba／hsl／hsv／cmyk に変換し、最も近い色名と WCAG 輝度、コントラスト（AA／AAA の判定）を返します。
url_metadata	URL を取得し、タイトル／説明／OpenGraph／Twitter Card／canonical／言語／hreflang／JSON-LD／ファビコン／レスポンスヘッダー／要素数を抽出します。SSRF 対策済みで、上限は 2 MB です。
meta_tags_generate	タイトル／説明／URL／画像から、完全な HTML head ブロック（meta + OpenGraph + Twitter Card + JSON-LD）を生成します。そのまま貼り付けられる HTML と、具体的な警告を含む 0～100 の SEO スコアを返します。
dns_lookup	システムリゾルバーを使って DNS レコード（A、AAAA、MX、TXT、NS、CNAME、SOA、CAA、PTR、SRV）を解決します。A レコードの逆引き PTR も含まれます。
ssl_check	ドメインの TLS 証明書を調査します。サブジェクト、発行者、有効期間、フィンガープリント、代替名、証明書チェーン全体、残り日数、ネゴシエートされたプロトコル／暗号スイートを確認できます。SSRF 対策済みです。

日付と時刻（3）

ツール	説明
timestamp	epoch ↔ ISO 8601 ↔ RFC 3339 ↔ 自然言語の相互変換に対応します。epoch の精度を自動検出します。タイムゾーンを考慮し、「"next monday"」「"+2 weeks"」などの自然言語も受け付けます。
date_math	日付に期間を加算／減算するか、2 つの日付の差を計算します。営業日数（月～金）のカウントも任意で行えます。
age_calc	生年月日から年／月／日単位の年齢を計算します。次の誕生日、誕生日までの日数、西洋占星術の星座、世代ラベルを返します。

ジェネレーターとソーシャル（2）

ツール	説明
random_gen	CSPRNG を利用したジェネレーターです。数値、文字列（アルファベット／英数字／数字／hex／base58／base64url）、単語、選択（復元あり／なし）、チーム分け、サイコロ（NdM）、コイン、国、UUID v4／v7 を生成します。
hashtag_tools	テキストのハッシュタグを操作します。抽出（オフセット付き）、削除、生成（ストップワードを除外した単語頻度を利用）、書式設定（camel／snake／小文字／そのまま）に対応します。Unicode を考慮します。

カタログは随時拡充されます。npx -y は常に公開済みの最新バージョンを取得します。新しいツールを利用するには、クライアントを再起動するだけです。

主要クライアント向けのインストール設定例

Claude Desktop

Claude Desktop の設定ファイルを開きます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

上記のクイックインストールから mcpServers エントリーを追加して、再起動します。

Claude Code

claude mcp add mate-tools npx -- -y @mate-tools/mcp-server

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "mate-tools": {
      "command": "npx",
      "args": ["-y", "@mate-tools/mcp-server"]
    }
  }
}

Windsurf およびその他の MCP クライアント

このサーバーは、標準の JSON-RPC 2.0 フレーミングを使い、stdio 経由で MCP を通信します。MCP 互換クライアントであれば、同じ形式の設定を使ってサブプロセスとして起動できます。

手動インストール（npx なし）

npm install -g @mate-tools/mcp-server
mate-tools-mcp   # speaks JSON-RPC over stdio; plug into a client

動作確認方法

インストール後、次のいずれかを AI エージェントに頼み、ツールが正しく接続されていることを確認してください。

「mate-tools を使って、この段落の行数と読了時間を数えてください。」

「文字列 secret を SHA-256 でハッシュ化してください。」

「曖昧な文字を含まない、20 文字の強力なパスワードを 10 個生成してください。」

「このパスワードの強度を評価してください：correct horse battery staple。」

「#ff5733 をすべての色空間に変換し、白との WCAG コントラスト比を教えてください。」

「3840 × 2160 のアスペクト比はいくつですか？」

「この 2 つの段落の差分を取ってください。」

「30 年ローンで、借入額が 30 万ドル、年利が 6.5％の場合、毎月の返済額はいくらですか？」

「1990-04-15 生まれの人は何歳ですか？ 星座は何ですか？」

「https://example.com/sitemap.xml から URL を再帰的にすべて抽出してください。」

「https://example.com のメタデータと OpenGraph タグを取得してください。」

「タイトルが … の記事向けに SEO メタタグを生成し、その結果を評価してください。」

「4d6 を振って最低値を除く方法を 6 回行ってください。」

「このキャプションに合うハッシュタグを提案してください。」

「example.com の MX レコードと TXT レコードを調べてください。」

「github.com の SSL 証明書は有効ですか？ 有効期限はいつですか？」

「この JWT をデコードして、有効期限が切れているか教えてください。」

エージェントが適切なツールを自動的に選択します。

仕組み

このサーバーは、依存関係のない約 600 行の単一の Node スクリプトです。各ツール呼び出しでは、次の処理を行います。

1. MCP クライアントから JSON-RPC の tools/call リクエストを受け取ります。
2. 引数を https://mate.tools/api/v1/{tool}.php の mate.tools 公開 API に転送します。
3. 読みやすい概要と完全な JSON レスポンスをクライアントに返します。

JSON-RPC の通信処理以外は、ローカルでは何も実行されません。計算は Cloudflare の背後にある mate.tools のサーバー上で行われます。各エンドポイントには、IP ごとに 60 リクエスト／分、600 リクエスト／時のレート制限が適用されます。

設定

API エンドポイントを上書きします（例：ステージング環境への接続テスト）。

MATE_TOOLS_API_BASE=https://staging.mate.tools/api/v1 npx -y @mate-tools/mcp-server

プライバシー

各ツール呼び出しでは、次の処理が行われます。

• ✅ MCP ツールに指定した引数のみを送信します。
• ✅ 通信には HTTPS を使用します。
• ✅ メモリ上で処理し、コンテンツをログに記録しません。
• ❌ テレメトリーを収集しません。
• ❌ アカウント、API キー、サインインは不要です。

mate.tools サーバーが記録するのは、リクエストメソッド、ハッシュ化した IP（毎日ローテーションするソルトを使用）、エンドポイント名、処理時間のみです。リクエストの内容は記録しません。

credit_card_validate と password_strength は、機密性の高い入力がリクエストハンドラーのメモリから外に出ないよう、明示的に設計されています。返されるのは検証結果とメトリクスのみです。

sitemap_extract、url_metadata、ssl_check は、名前解決の結果がプライベート（RFC 1918）、ループバック、リンクローカル、またはクラウドメタデータ用の IP アドレスとなるホストへのフェッチ／接続を拒否します。HTTP ベースのツールでは、リダイレクト先も毎回再検証するため、302 を使った SSRF 攻撃は機能しません。url_metadata はレスポンス本文を 2 MB に制限します。ssl_check は接続タイムアウトを 5 秒に設定しています。

jwt_decode はトークンを記録しません。デコードはすべてリクエストハンドラーのメモリ内で行われ、日次アクセスログに記録されるのはアルゴリズム名、署名検証の結果、リクエスト処理時間のみです。本番環境のトークンにも安心して使用できます。

regex_test はリクエストごとに PCRE のバックトラック数を 100,000 ステップに制限します。壊滅的な正規表現パターンは、サーバーをハングさせることなく、適切な 422 を返します。

random_gen は PHP の random_int／random_bytes（CSPRNG）を使用し、メルセンヌ・ツイスターは使用しません。UUID は、バージョン／バリアントのビットが適切に設定された RFC 4122 v4、またはミリ秒精度のタイムスタンプを持つ v7 です。

ソースコードとドキュメント

• npm： https://www.npmjs.com/package/@mate-tools/mcp-server
• ソースコード（単一ファイル）： https://mate.tools/api/mcp/server.js
• スクリーンショット付きインストールガイド： https://mate.tools/api/mcp
• JSON API リファレンス： https://mate.tools/api
• OpenAPI 3.1 仕様： https://mate.tools/api/openapi.json
• llms.txt： https://mate.tools/llms.txt

問題・フィードバック

mate.tools のお問い合わせフォームから問題を報告してください。件名に「@mate-tools/mcp-server」と記載してください。新しいツールはおよそ1〜2週間ごとに追加されます。利用したいユーティリティがあれば、お気軽にご連絡ください。

ライセンス

MIT — 個人利用・商用利用ともに無料です。LICENSEをご覧ください。