Deno Gemini Grounding MCP Server
About
A Model Context Protocol server that provides access to the connpass users API v2, utilizing Gemini for grounding.
Details
- Author
- rinerebox1
- Categories
- Developer Tools, API, Other, AI
Jump to
Setup
Install Deno Gemini Grounding MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/rinerebox1/deno-gemini-grounding-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol server that provides access to the connpass users API v2, utilizing Gemini for grounding.
https://github.com/rinerebox1/deno-gemini-grounding-mcp-server
Docker を使ってクリーンアップ・ビルド・起動する。MCPサーバーが起動してそこで止まる。ただ、これだけあっても用途は良く分からない。
簡単にMCPサーバーを起動する方法(Docker を使わない):deno task start
テスト: deno task test:tokyo deno task test:google_search deno task test:google_search_simple
- 実装するファイル
- index.ts で server.tool を追加する
- tools フォルダで Tool を定義する(get~~.ts)
- tools/helpers/formatHelpers.ts で出力フォーマットの整形
- deno.json に追加
- deno.lock のアップデート方法:
- rm -rf ~/.cache/deno && deno cache --reload index.ts
- アップデートできたかは以下で確認:
- ls -la deno.lock && head -10 deno.lock
- tests フォルダにテストコードを実装
- 次に deno.json の tasks にテストファイルの追加
テストが通ったら MCPサーバーが実装できたということなので 「C:\Users\kbpsh\OneDrive\development\MCP\deno-gemini-grounding-mcp-client」の方で 「.gemini/settings.json」に追記する。 Gemini CLI から MCPサーバーを利用する。 「deno-gemini-grounding-mcp-client」の方はWSLで起動しないこと。WSLとMCPクライアントの相性が悪そうなので、MCPクライアントはWindows側にする。
- v1: Connpass機能あり + 基本的なGenAI機能(stdio)
- v2: Connpass機能削除 + 東京観光特化のGenAI機能(stdio)
- v3: v2 を改良して Cloudflare Workers対応(Hono サーバーでちゃんと動いたが、Cloudflareへのデプロイはしていない)(Streamable HTTP)
- v4: v2の改良版。Gemini のグラウンディング MCPサーバーを追加。Cloudflare Workersの対応はしていない(stdio)
https://cloud.google.com/vertex-ai/generative-ai/pricing?hl=ja
Gemini Flash 2.5 なら1日 1500 件まで無料で検索可能。Lite も一緒。だいたい1回検索で3クエリくらい消費する。
ファイル読み取りや環境変数アクセス、ネットワーク接続などは Deno のセキュリティモデル上 --allow-read、--allow-env、--allow-net などのフラグで制御されますが、これらもあくまで【ローカル実行時にのみ有効】【リモートでは使えない】です
Cursor かつ WSL 側で MCP Tool を登録するのがかなり難しい。とりあえず、Cドライブ側で Gemini CLI から MCP サーバーを認識できたので OK とする。ただ、Cドライブ側でも Cursor での MCP Tool 呼び出しはできないので、Cursor で MCP 使うのは止める。
以下でチェックできる。 echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | deno run --env-file=.env --allow-net=generativelanguage.googleapis.com --allow-env --allow-read index.ts
- (Connpass APIキーをすでに取得済の場合はスキップ)Connpass APIキーの発行をしてもらいます。詳細についてはconnpassのAPI利用についてを参照してください。
- このリポジトリをクローンします。
- 必要な環境変数を設定します。.env.exampleを.envにコピーして、Connpass APIキーを設定します。
cp .env.example .env # .envファイルを編集してCONNPASS_API_KEYを設定
"deno-gemini-grounding-mcp-server": { "command": "wsl.exe", "args": [ "/home/smorce/.deno/bin/deno", "--allow-net=generativelanguage.googleapis.com", "--env-file=/home/smorce/MCP/deno-gemini-grounding-mcp-server/.env", "--allow-read", "--allow-env", "/home/smorce/MCP/deno-gemini-grounding-mcp-server/index.ts" ] }
"deno-gemini-grounding-mcp-server": { "command": "wsl.exe", "args": [ "/home/user/.local/share/mise/installs/node/22.14.0/bin/node", "--env-file=/home/smorce/MCP/deno-gemini-grounding-mcp-server/.env", "/home/smorce/MCP/deno-gemini-grounding-mcp-server/dist/index.js" ] }
# .envファイルを作成し、以下の内容を設定 echo "GEMINI_API_KEY=your_gemini_api_key_here" >> .env
docker compose run vs docker compose up の違い
- サービス全体を起動し、フォアグラウンドで継続実行
- ログが表示され続け、Ctrl+Cで停止するまで動作
- 開発・テスト時のサーバー起動に適している
- 一回限りのコマンド実行に使用
- コンテナを起動してコマンドを実行し、完了後に自動終了
- MCPクライアントからの呼び出しに適している
# 起動スクリプトを実行(クリーンアップ→ビルド→起動を自動実行) ./start.sh
⚡ MCP用(一回限りの実行):MCPクライアント経由で自動実行されます。手動テストする場合:
docker compose run --rm deno-gemini-grounding-mcp-server
MCPクライアントの設定ファイルでは、docker compose runコマンドを指定します。 MCPサーバーはstdin/stdoutでの対話的通信が必要なため、設定は以下のようになります(先にビルドが必要):
{ "mcpServers": { "deno-gemini-grounding-mcp-server": { "command": "docker", "args": [ "run", "-e", "GEMINI_API_KEY=XXXXXXXXXXXXXXXX", "deno-gemini-grounding-mcp-server" ] } } }
docker build -t deno-gemini-grounding-mcp-server .
docker run -e CONNPASS_API_KEY=XXXXXXXXXXXXXXXX -e GEMINI_API_KEY=YYYYYYYYYYYYYYYY deno-gemini-grounding-mcp-server
"deno-gemini-grounding-mcp-server": { "command": "docker", "args": [ "run", "-e", "GEMINI_API_KEY=YYYYYYYYYYYYYYYY", "deno-gemini-grounding-mcp-server" ] }
このリポジトリをクローンしてDenoまたはNode.jsでMCPサーバーの起動が可能です。
"deno-gemini-grounding-mcp-server": { "command": "wsl.exe", "args": [ "/home/smorce/.deno/bin/deno", "--allow-net=generativelanguage.googleapis.com", "--env-file=/home/smorce/MCP/deno-gemini-grounding-mcp-server/.env", "--allow-read", "--allow-env", "/home/smorce/MCP/deno-gemini-grounding-mcp-server/index.ts" ] }
ただしnpxでMCPサーバーを起動するのはサプライチェーン攻撃などのセキュリティ的な懸念があるため非推奨としています。
-
get_connpass_user_list- Connpassユーザーの基本情報を取得します
- パラメータ:nickname(Connpassユーザー名/ニックネームの配列)
- 取得情報: 参加イベント数、管理イベント数、発表イベント数、ブックマークイベント数
get_connpass_user_group_list- Connpassユーザーが所属するグループ一覧を取得します
- パラメータ:nickname(Connpassユーザー名/ニックネーム)
- 取得情報: グループ名、URL、説明、参加者数など
get_connpass_user_events- Connpassユーザーが参加したイベント情報を取得します
- パラメータ:nickname(Connpassユーザー名/ニックネーム)
- 取得情報: イベント名、日時、場所、URL、説明
get_connpass_user_presenter_events- Connpassユーザーが発表者として参加したイベント情報を取得します
- パラメータ:nickname(Connpassユーザー名/ニックネーム)
- 取得情報: イベント名、日時、場所、URL、説明
- 「yamanoku, okuto_oyamaさんのConnpassユーザー情報を教えて」
- 「yamanokuさんの参加するConnpassイベント情報を教えて」
- 「yamanokuさんの発表したConnpassイベント一覧を表示して」
- 「yamanokuさんのConnpass所属グループを一覧表示して」
以下のようなアウトプットになっていれば成功。30秒の安全タイムアウトが作動しているのは正常な動作。
🔍 === レスポンス検証 === ✅ キーワード検出: 5/5 - "東京" ✓ - "魅力" ✓ - "多様性" ✓ - "文化" ✓ - "食" ✓ 🎉 テスト成功: 東京の魅力について適切にレスポンスしました! 📊 レスポンス統計: - 文字数: 1541 - 行数: 15 ✅ MCPサーバープロセス終了 (コード: 143) ⏰ タイムアウト: プロセスを終了します
このOSSはGPT-4o Image Generationによってロゴを製作、Claude 3.7 Sonnetによって実装、ドキュメントのサンプルを提案いただきました。感謝申し上げます。
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Access Valyu's knowledge retrieval and feedback APIs.
Real-time Amazon data API built for AI agents. 200M+ products, 1B+ reviews, live BSR, pricing, and competitor data as clean JSON. 10 agent skills for market research, competitor monitoring, pricing, listing audits, and more. 1,000 free credits.
Get access to Kaggle's datasets, models, competitions, notebook and benchmarks.
Generate images using the Together AI API. Supports custom aspect ratios, save paths, and batch generation.
Identity infrastructure for the AI economy. 33-trait psychometric engine — belonging probability, trait vectors, attunement depth. Remote streamable-HTTP. Free tier: 16 tools, 10 req/min.
An unofficial MCP server for the Artificial Analysis API
Access 30+ AI models in Claude Code with zero API keys. One wallet, pay-per-request.
An image generation server that connects to a local ComfyUI instance via its API, supporting dynamic workflows.
An MCP server for interacting with Dappier's Retrieval-Augmented Generation (RAG) models.
Provides a full suite of AI tools via DeepInfra’s OpenAI-compatible API, including image generation, text processing, embeddings, and speech recognition.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





