FreeBSDでgemini-cliとMCPを試してみる

はじめに

ＡＩツールとして「何とかＣＬＩ」がいくつか出回っていますが、ＦｒｅｅＢＳＤで稼動するもの…となると数は少ないです。自分が把握しているものとしては gemini-cli と github-copilot-cli くらいで。
claude-cli に興味を持っていたこともありましたが、ＦｒｅｅＢＳＤで試しても動かなかったこと（今は動くという話も）、gemini-cli がｐｏｒｔｓにあることを偶然知ったこと、既にグーグルに魂を売ってた（アカウントは作ってた）こと、から、試しに導入してみました。

注意

• 何でか大量にメモリ食います。これ動かすだけで１０ＧＢ使う言うてる。実メモリだけで３００ＭＢ…。
• 今回試したＭＣＰ一つに１ＧＢ強のストレージ容量を食います。
• これ書いてる、修正している間にバージョンアップがｗ。

導入方法

sudo pkg install -y gemini-cli

その後 gemini コマンドがインストールされます。自分としては下記の設定を事前に入れておくくらいです。
もちろん入れなくても良いし、このレベルの設定であれば設定画面（/settings コマンド）で設定可能です。

~/.gemini/settings.json

{
  "general": {
    "previewFeatures": true,
    "vimMode": true
  },
  "ui": {
    "showModelInfoInChat": true
  }
}

ちなみにですが、自分が端末アプリとして使ってるＰｕＴＴＹだと、イケてない表示になるので、Ｗｉｎｄｏｗｓ Ｔｅｒｍｉｎａｌの使用をお勧めします。もしかしたら上手く設定すればイケるのかもしれませんが、調べてないです。またＦｒｅｅＢＳＤネイティブのコンソールでもイケてるかは分からないです。
余談ですが１６０桁×５０行くらいで使うのがちょうどいい感じの表示になります。

1. Login with Google を選びます（エンターキーを押す）。

ＵＲＬが表示されるので、そのＵＲＬをブラウザにコピペしてアクセス、グーグルにログインしたら、アプリからの使用許可表示に対して、許可を行い、最後 Sign in to Gemini Code Assist and the Gemini CLI という画面で表示される認証コードを端末にコピーして設定は完了です。

一応この瞬間から使えるようにはなります。/settings と打って設定するもよし、/quit と打って終了するもよし、で。

ＭＣＰにつないでみよう！

どんなネタを…と考えるところですが、ＡＷＳで色々試していたので一つ紹介してみます。無料でかつアカウントレスで使えるドキュメント系のＭＣＰサーバーであるところの awslabs.aws-documentation-mcp-server と aws-knowledge-mcp-server につないでみます。

導入手順としては下記のサイトに書いてある手順を参考に実施します。

uv のインストールをしろ、とありますが、ＦｒｅｅＢＳＤでは pkg コマンドで実施します。

sudo pkg install -y uv

またＭＣＰの設定についてですが、現時点¹では設定画面で行えません。コマンドラインで設定するか ~/.gemini/settings.json を直接編集します。
ただし settings.json を編集…と言っても若干、仕様が違ってるようで、そのままコピペしても動きません。その辺り込みでコマンドラインに落とし込んで設定するものとします。

またドキュメント記載の内容をそのまま設定すると、毎回毎回、非常に時間の掛かる初期化が実行されます（uvxの仕様）。毎回初期化を行うという無駄な処理を行わないため、最適化を実施します²。

その辺り込みで、以下のコマンドで設定を行います。

uv tool install awslabs.aws-documentation-mcp-server@latest
gemini mcp add -s user -t stdio -e FASTMCP_LOG_LEVEL=ERROR -e AWS_DOCUMENTATION_PARTITION=aws awslabs.aws-documentation-mcp-server uv run awslabs.aws-documentation-mcp-server

gemini mcp add -s user -t http aws-knowledge-mcp-server https://knowledge-mcp.global.api.aws

閑話休題。手動で編集した場合、以下のようにマージされた状態となることが期待されます。jq コマンド等を使用してＪＳＯＮとしてのフォーマットが正しいか確認してください（, の抜け漏れとか過剰な , とか）³。

~/.gemini/setting.json

{
  "general": {
    "previewFeatures": true,
    "vimMode": true
  },
  "ui": {
    "showModelInfoInChat": true
  },
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "awslabs.aws-documentation-mcp-server"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws"
      }
    },
    "aws-knowledge-mcp-server": {
      "httpUrl": "https://knowledge-mcp.global.api.aws"
    }
  }
}

試してみる

以下のプロンプトを実行してみます。

CloudFront+S3構成するためのCloudFormationのサンプル（YAML）を提案してください。

WriteFile Writing to cloudfront-s3.yaml と結果が表示されてファイルを保存するか聞いてくるので保存します（Yes, allow once）。

とりあえず保存された cloudfront-s3.yaml というファイルの内容を確認した限りは上手く記述されてるように見えました。

ＭＣＰありと無しとで比較すると…なんとも言えない微妙な差分。まだ使いこなせてないのかもしれない。

というわけでスペックについて聞いてみました。

AWS Lambda の関数名の長さ制限について教えてください。

ＭＣＰ使っていいのかと聞いてきますね。

というわけで、上手く回答が得られました。

コマンドラインについて

ｇｅｍｉｎｉ

• gemini mcp list
• gemini mcp add
  • -s： スコープ（user または project）。user の時は ~/.gemini/settings.json に、project の場合は .gemini/settings.json に保存されます。
  • -t： トランスポート（stdio、sse、http）。コマンド指定するなら stdio、ＵＲＬ指定するなら（たいてい）httpを指定します。
  • -e： 環境変数の指定
  • -H： リクエストヘッダーの指定
  • その他（他にも色々あります）
• gemini mcp remove
  • -s： スコープの指定（user または project）。gemini mcp add と同じ。

ｕｖ

作業にあたっていくつか使ったコマンドの一覧です。これ自体はテーマでないので紹介レベルで。

• uv cache prune
• uv cache size --preview-features cache-size
• uv cache clean
• uv tool list --show-paths
• uvx awslabs.aws-documentation-mcp-server@latest →

uv tool install awslabs.aws-documentation-mcp-server@latest
uv tool run awslabs.aws-documentation-mcp-server

• uv tool update awslabs.aws-documentation-mcp-server

ポリシーエンジン

色々と作業しているとＭＣＰへの問い合わせやコマンドを無条件に実行して欲しい時があります。
そのような時に Policy Engineの設定を行います。

例えばＡＷＳ ＭＣＰへの問い合わせを無条件に許可するのであれば下記の手順でファイルを作成します。

mkdir -p ~/.gemini/policies

このディレクトリにて以下のＴＯＭＬファイルを作成します（名前はわかり安めに適度に決める）。

~/.gemini/policies/aws-mcp-servers.toml

[[rule]]
toolName = [
  "aws___search_documentation",
  "aws___read_documentation",
  "aws___recommend",
  "aws___list_regions",
  "aws___get_regional_availability",
  "search_documentation",
  "read_documentation",
  "recommend"
]
decision = "allow"
priority = 100

このリストをどうやって生成すればいいのか？についてＧｅｍｉｎｉ上で /mcp list を実行すればそれぞれのＭＣＰでのツール一覧が表示されます。これを取り込みます。

 > /mcp list
Configured MCP servers:

🟢 awslabs.aws-documentation-mcp-server - Ready (3 tools)
  Tools:
  - read_documentation
  - recommend
  - search_documentation

🟢 aws-knowledge-mcp-server - Ready (5 tools)
  Tools:
  - aws___get_regional_availability
  - aws___list_regions
  - aws___read_documentation
  - aws___recommend
  - aws___search_documentation

今回は「許可」でしたが「拒否」の設定も可能です。組み合わせとしてどうなるかまでは検証していませんが、とりあえずこの設定を実施して、だいぶ調査がはかどるようにはなりました。

よくある質問とその答え

Ｑ．なぜＶＩＭモードを推奨するｗ

Ａ．改行したいのに改行入力の取り扱いが微妙だったので。どう改行入れればいいのか考える前にＶＩＭモードで編集しちゃいました。
まぁ入力モードでも問題起こるわけですがたぶん CTRL+RETURN かな。

Ｑ．喧嘩売ってる？

Ａ．ＶＩＭモードで無い時の、プロンプトを書いた後に、エラーログを貼り付けたかった時の苦労を味わってみてください。

Ｑ．改行の入力方法は？

Ａ．CTRL+RETURN で。

Ｑ．ろくに参考文献が無いじゃないか

Ａ．理解のために色々読みましたが、みんなこの程度理解してて当然、と省略されている部分が沢山あって、理解した後は参考とするには微妙でした。
せめて一次サイトの紹介はすべきではないかと。
そういう意味ではＭＣＰとは？という点を押さえてないという意味で、この文書もあまり良くないと思わなくも無いです。

なお uvx の問題についても、Ｇｅｍｉｎｉと相談してトライアンド＆エラーで最適化しています。

参考文献

• Gemini CLI
• Gemini CLI Policy engine
• Gemini CLIのPolicy engineでコマンドとMCPツールの実行を制御する
• GitHub Copilot CLI
• AWS MCP Servers
• AWS MCP Servers - Installation
• AWS Documentation MCP Server
• AWS Knowledge MCP Server
• AWS MCP Server - Tools
• Gemini Code Assist - gemini-cli

ＧｅｍｉｎｉのことはＧｅｍｉｎｉに聞くしか。

1. ２０２５年１２月０４日現在（0.18.4）、同０５日現在（0.19.1）。 ↩

2. 他の環境ではこの辺りの手間はどうなってるんでしょう？キャッシュが効いてるとかあるのかな。 ↩

3. ＡＷＳのドキュメントだと url と記載されているものの gemini-cli だと httpUrl となっています。直接編集する場合は要注意です。 ↩