formatika

@formatika/mcp

formatika.app を使って、エージェントから直接ファイルを変換、サイズ変更、圧縮、トリミング、回転できます。

エージェントはツールを利用できます。ファイルは処理が必要になるまでお使いのマシンにとどまり、処理が完了するとすぐに戻されます。

使い方

インストールもアカウントも不要で、すぐに始められます。

npx @formatika/mcp

Claude Code

claude mcp add formatika -- npx -y @formatika/mcp

Claude Desktop、Cursor、その他のクライアント

クライアント設定の MCP サーバーのセクションに、以下を追加してください。

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

Windows では、Claude Desktop はシェルを使わずにサーバーを起動するため、npx を直接見つけられません。代わりに、こちらを使ってください。

{
  "mcpServers": {
    "formatika": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@formatika/mcp"]
    }
  }
}

設定を編集した後は、クライアントを完全に再起動してください。

あとは普通に頼むだけ

./screenshots 内の写真をすべて圧縮して、結果を ./web に保存してください

このフォルダー内の HEIC ファイルをすべて JPEG に変換してください

portrait.png から 512×512 の正方形のアバターを作成してください

ツール

ツールの一覧は起動時にサービスから取得されるため、formatika で実際に利用できる機能と常に一致します。新しいツールがエージェントに表示されても、この README を更新する必要はありません。

現在は、画像、音声、動画、PDF、アーカイブ、字幕、表に対応しており、ツールは 30 種類以上あります。現在の一覧と各ツールの機能は、formatika.app/mcp をご覧ください。

各ツールは、1 つ以上のファイルを指定する paths と、任意の outputDir を受け取ります。別の場所を指定しない限り、結果は元のファイルの隣に保存されます。また、既存のファイルが上書きされることはありません。同名のファイルがある場合は、名前に番号が追加されます。

制限とキー

キーがなくても 1 日あたりの利用枠があり、たまに使う程度であれば十分です。大量に利用する場合は、formatika.app/account でキーを作成し、次のように渡してください。

{
  "mcpServers": {
    "formatika": {
      "command": "npx",
      "args": ["-y", "@formatika/mcp"],
      "env": { "FORMATIKA_API_KEY": "fk_..." }
    }
  }
}

FORMATIKA_URL を設定すると、サーバーの接続先を変更できます。formatika を自分で実行する場合に便利です。

プライバシー

ファイルは処理後に削除されます。アカウントがない場合は 2 時間後、アカウントがある場合は 24 時間後に削除されます。ファイルを閲覧、共有したり、何らかの学習に使用したりすることはありません。プライバシーポリシーをご覧ください。

ライセンス

MIT

---

このリポジトリについて

このリポジトリは、formatika モノレポの packages/mcp ディレクトリを読み取り専用でミラーしたものです。このパッケージの公開ホームとして提供しており、カタログからリンクできるほか、インストール前にコードを確認したい方にもご利用いただけます。

こちらへのプルリクエストはマージできません。次回の同期で上書きされるためです。ただし、問題は確認しますので、バグ、ツールの不足、使いにくい API などの報告を歓迎します。

コミット e06be38 からミラーされています。