chatmcp

インストール

macOS	Windows	Linux	iOS	Android	Web
リリース	リリース	リリース ¹	TestFlight	リリース	GitHub Pages ²

¹ Linux の注意事項：

• Ubuntu 22.04 および 24.04 での AppImage／DEB のランタイム依存関係については、以下の Linux の要件をご覧ください。
• より快適な利用体験：最新バージョンではダークテーマのサポートが強化され、XDG Base Directory Specification に準拠したデータストレージの統一や、Linux デスクトップ環境向けに最適化された UI レイアウトが予定されています。
• 主要なディストリビューションでテスト済みです：Ubuntu、Fedora、Arch Linux、openSUSE

² 注：Web 版はすべてブラウザー内で動作し、チャット履歴と設定はローカルストレージに保存されます。

ドキュメント

chatmcp の詳細情報を知るには、DeepWiki もご利用いただけます。
DeepWiki は、公開されている GitHub リポジトリを、インタラクティブで理解しやすい Wiki に変換する AI 搭載プラットフォームです。コード、ドキュメント、設定ファイルを分析してわかりやすい解説やインタラクティブな図を作成し、AI とのリアルタイムな質疑応答も可能にします。

プレビュー

データ同期

ChatMCP アプリケーションは、同じローカルエリアネットワーク内でデータを同期できます。

使用方法

システムに uvx または npx がインストールされていることを確認してください。

MacOS

# uvx
brew install uv

# npx
brew install node 

Linux

# uvx
curl -LsSf https://astral.sh/uv/install.sh | sh

# npx (using apt)
sudo apt update
sudo apt install nodejs npm

Linux の要件（Ubuntu 22.04 および 24.04）

Ubuntu およびその派生ディストリビューションで ChatMCP AppImage/DEB を実行するには、次のランタイムパッケージをインストールしてください。

• AppImage（FUSE）：libfuse2
• GTK 3：libgtk-3-0
• グラフィックス/EGL：
  • Ubuntu 22.04：libegl1-mesa、libgles2、libgl1-mesa-dri、libglx-mesa0
  • Ubuntu 24.04：libegl1、libgles2、libgl1-mesa-dri、libglx-mesa0
• X11 ユーティリティと SQLite：libx11-6、xdg-utils、libsqlite3-0

インストールコマンド：

• Ubuntu 22.04：

sudo apt install -y libfuse2 libgtk-3-0 libegl1-mesa libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev

• Ubuntu 24.04：

sudo apt install -y libfuse2 libgtk-3-0 libegl1 libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0 libsqlite3-dev

任意（推奨）：mesa-vulkan-drivers、mesa-utils（glxinfo などの診断用）

1. Setting ページで LLM API キーとエンドポイントを設定します
2. MCP Server ページから MCP サーバーをインストールします
3. MCP サーバーとチャットします

• stdio MCP サーバー

• sse MCP サーバー

データストレージ

ChatMCP は、データストレージに関するプラットフォーム固有のベストプラクティスに従っています。

ストレージの場所

macOS：

~/Library/Application Support/ChatMcp/

Windows：

%APPDATA%\ChatMcp\

Linux：

~/.local/share/ChatMcp/           # Honors $XDG_DATA_HOME if set
~/.local/share/run.daodao.chatmcp # Flutter dependency

モバイル：

• アプリケーションのドキュメントディレクトリ

ファイル構造

すべてのプラットフォームで、統一されたディレクトリ構造にデータが保存されます。

• logs フォルダー - アプリケーションログ
• chatmcp.db - チャット履歴とメッセージを含むメインデータベースファイル
• shared_preferences.json - アプリケーションの設定と環境設定
• mcp_server.json - MCP サーバーの設定

アプリケーションデータのリセット

アプリケーションを完全にリセットするには（すべてのチャット履歴、設定、構成を削除します）：

macOS：

rm -rf ~/Library/Application\ Support/ChatMcp

Windows：

rd /s /q "%APPDATA%\ChatMcp"

Linux：

rm -rf ~/.local/share/ChatMcp
rm -rf ~/.local/share/run.daodao.chatmcp

開発

Flutter のインストール

ChatMCP を開発または実行するには、Flutter がインストールされている必要があります。
ご利用のプラットフォームに対応する公式の Flutter インストールガイドに従ってください。

• Flutter をダウンロード

インストール後、次のコマンドで確認してください：

flutter --version

必須のコードフォーマットとコミット前フック

コントリビューター間で一貫したコードスタイルを保つため、このリポジトリではすべてのコミットで Dart のフォーマットを必須としています。

• このリポジトリには、バージョン管理された Git フック .githooks/pre-commit が含まれています。
• コミット時に dart format . を実行し、変更されたファイルを再度ステージングした後、フォーマットされていないファイルが残っていないことを確認するため、出力なしのチェックを実行します。
• 適切にフォーマットされていないコミットはローカルで拒否されます。また、フォーマットされていない PR は CI で失敗します。

簡単なセットアップ（クローンごとに 1 回）：

make setup-git-hooks

手動セットアップ（代替方法）：

git config core.hooksPath .githooks
chmod +x .githooks/pre-commit

要件（少なくとも 1 つが PATH 上で利用可能である必要があります）：

• Dart SDK、または
• Flutter（Dart が同梱されています）

例：

• macOS/Linux（Flutter）：

  export PATH="$PATH:$HOME/flutter/bin"
  which flutter && flutter --version
  which dart && dart --version
  

• macOS/Linux（Dart SDK）：

  export PATH="$PATH:$HOME/dart-sdk/bin"
  which dart && dart --version
  

• Windows（PowerShell）：C:\\src\\flutter\\bin（または Flutter のパス）をユーザーまたはシステムの PATH に追加します。次のコマンドで確認してください：

  where flutter
  where dart
  

IDE に関する注意：PATH を変更した後は IDE を再起動し、VCS 操作（コミット）で更新された環境が引き継がれるようにしてください。

CI での適用：

• GitHub Actions のワークフロー check-format は、push/PR 時に dart format --output=none --set-exit-if-changed . を実行し、フォーマットされていないファイルがある場合は失敗します。

ポリシー：

• フックを回避しないでください（例：--no-verify）。そのような変更は CI で失敗し、いずれにしても再フォーマットが必要です。

ローカルでクローンして実行

# Clone the repository
git clone https://github.com/daodao97/chatmcp.git
cd chatmcp

# Install dependencies
flutter pub get

# Run on macOS
flutter run -d macos

# Run on Linux (requires Flutter desktop support enabled)
flutter run -d linux

# Build release for Linux
flutter build linux

Web 版

ローカル開発

# Install dependencies
flutter pub get

# Run Web version locally
flutter run -d chrome
# Or specify port
flutter run -d chrome --web-port 8080
# Or run as web-serer for other browsers.
flutter run -d web-server

Web 版のビルド

# Build production version
flutter build web

# Build with base path (for deploying to subdirectory)
flutter build web --base-href /chatmcp/

GitHub Pages へのデプロイ

# 1. Build Web version
flutter build web --base-href /chatmcp/

# 2. Push build/web directory contents to gh-pages branch
# Or use GitHub Actions for automatic deployment

ビルド後、ファイルは build/web ディレクトリに保存され、任意の静的ウェブサイトホスティングサービスにデプロイできます。

機能

• MCP サーバーとのチャット
• MCP サーバーマーケット
• MCP サーバーの自動インストール
• SSE MCP トランスポートのサポート
• MCP サーバーの自動選択
• チャット履歴
• OpenAI LLM モデル
• Claude LLM モデル
• OLLama LLM モデル
• DeepSeek LLM モデル
• RAG
• より良い UI デザイン
• ダーク／ライトテーマ

機能の提案はすべて歓迎します。Issues でアイデアやバグを報告できます。

MCP サーバー マーケット

MCP サーバー マーケットから MCP サーバーをインストールできます。MCP サーバー マーケットは MCP サーバーのコレクションで、さまざまなデータとチャットするために使用できます。

• MCP サーバー マーケットに新しい MCP サーバーを追加することもできます：MCP Server Market

mcp_server_market をフォークし、ファイル末尾の mcp_server_market.json に MCP サーバーを追加してください。

{
    "mcpServers": {
        "existing-mcp-servers": {},
        "your-mcp-server": {
              "command": "uvx",
              "args": [
                  "--from",
                  "git+https://github.com/username/your-mcp-server",
                  "your-mcp-server"
            ]
        }
    }
}

MCP Server Market リポジトリにプルリクエストを送信して、MCP サーバーをマーケットに追加できます。プルリクエストがマージされると、MCP サーバーがマーケットで利用可能になり、ほかのユーザーもすぐに使用できます。

皆さまからのフィードバックは、chatmcp の改善や、ほかのユーザーが十分な情報に基づいて判断するために役立ちます。

謝辞

• MCP
• mcp-cli

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。

スター履歴