mcpField
A
Atlarium Habitat Database MCP

Atlarium Habitat Database MCP

リモート
github.com/techgardenersデータベース07 週間前に更新
リポジトリ

Atlarium Habitat Database MCP について

Atlarium Habitat Database MCPは、水槽などの飼育環境データを扱うAIエージェントやクライアント向けの公開読み取り専用サーバーです。生物・製品情報、診断、計算、計画ツールに加え、ガイド付きプロンプトとApps対応ウィジェットを備えています。

主な機能

  1. 01生物、植物、製品、ガイドの検索
  2. 02公開プロフィールの構造化データ取得
  3. 03生物の相性と水質条件の確認
  4. 04診断と治療情報の検索
  5. 05水槽、水量、肥料の数値計算
  6. 06プロンプトとウィジェットによる環境計画

活用シーン

  1. 01水槽に適した生物や植物の調査
  2. 02水槽条件に基づく相性確認
  3. 03藻類、病気、植物の問題候補を調査
  4. 04水槽の必要条件の推定や飼育環境の計画

MCP 対応

Streamable HTTP経由で、認証不要の公開読み取り専用ツール39種とガイド付きプロンプト9種を提供します。Apps対応ホスト向けに読み取り専用のHabitat Explorerウィジェットも公開します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.atlarium.bio/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

39
パラメーター型必須説明
querystringいいえ公開 Atlarium レコードとの照合に使用する検索テキスト。
languageenumいいえ任意の優先応答言語:it、en、es。it | en | es
min_tank_litersnumberいいえリットル単位の水槽容量の最小値フィルター。
max_tank_litersnumberいいえリットル単位の水槽容量の最大値フィルター。
ph_minnumberいいえ許容される pH の最小値フィルター。
ph_maxnumberいいえ許容される pH の最大値フィルター。
gh_minnumberいいえ総硬度の最小値フィルター。
gh_maxnumberいいえ総硬度の最大値フィルター。
kh_minnumberいいえ炭酸塩硬度の最小値フィルター。
kh_maxnumberいいえ炭酸塩硬度の最大値フィルター。
temperature_minnumberいいえ摂氏で指定する温度の最小値フィルター。
temperature_maxnumberいいえ摂氏で指定する温度の最大値フィルター。
temperamentstringいいえ性質のフィルター。例:温和、攻撃的。
care_levelstringいいえ飼育難易度のフィルター。例:初心者向け、中級者向け、上級者向け。
limitintegerいいえ返す公開レコードの最大数。上限は 50 件です。
offsetintegerいいえ公開検索結果の 0 始まりのページネーションオフセット。

詳細

Atlarium Habitat Database MCP のソーシャルプレビュー

Atlarium Habitat Database MCP

Atlarium の生息環境データ、診断、製品、計算ツール、アドバイザリープランニングを提供する、一般公開の読み取り専用 MCP サーバーです。

一般公開 MCP モニター MCP ディレクトリ監査 MIT ライセンス 公式 MCP レジストリ バージョン 2.0.3 トランスポート:Streamable HTTP 読み取り専用 MCP ツール プロンプト有効 認証なし

MCP エンドポイント · 人間向けドキュメント · サーバーカード · 技術ドキュメント · クライアントの例

Atlarium Habitat Database MCP は、AI エージェントに、水槽、海水水槽、冷水環境、テラリウム、パルダリウム、ビバリウム向けの Atlarium の公開データとアドバイザリー機能への構造化されたアクセスを提供します。種、植物、製品、ガイド、藻類、病気、植物の問題、薬剤、相性、施肥、計算ツール、生息環境の包括的なプランニングに対応する39個の一般公開読み取り専用ツールを提供し、Atlarium アカウント、プライベートワークスペース、管理 API、書き込み操作にはアクセスできません。

概要

項目値
MCP エンドポイントhttps://mcp.atlarium.bio/mcp
MCP バージョン2.0.3
トランスポートStreamable HTTP
認証なし
ツールの範囲一般公開の読み取り専用ツール39個
プロンプトガイド付きの一般公開プロンプト9個
Apps ウィジェットui://widget/habitat-explorer.v4.html
サーバーカードhttps://mcp.atlarium.bio/.well-known/mcp/server-card.json
人間向けドキュメントhttps://atlarium.bio/mcp
公式 MCP レジストリbio.atlarium/habitat-database

https://atlarium.bio/mcp はドキュメントです。正規の Streamable HTTP MCP エンドポイントは https://mcp.atlarium.bio/mcp です。

構築できるもの

ユースケース公開ツール
種の調査魚、水生動物、水生植物を検索し、ローカライズされた構造化プロフィールを取得します。
水槽の適合性水槽のサイズ、pH、硬度、温度の条件に照らして種を比較します。
診断の初期評価公開プロフィールから藻類、水生生物の病気、水草の問題、治療に関する情報を検索します。
製品の選定製品カテゴリー、ブランド、器具、肥料を探します。
施肥のサポート施肥方法を検索し、製品の使用量、栄養素の不足、週間合計量を計算します。
水槽計算ツール水槽の容量、重量、水換え、水質、単位換算、必要な器具を見積もります。
生息環境の計画生物、水草、製品、警告、選定理由、関連ガイドを含む、水槽の包括的なアドバイスプランを作成します。
ガイドの取得Atlarium の公開教育コンテンツを検索して取得します。

すべての出力は参考情報です。適合性チェック、診断、施肥プラン、器具の 見積もり、水槽計算ツール、水槽の提案は、実際の飼育生物、器具、水質、 地域の規制、飼育上の制約に照らして確認してください。

クイックスタート

リモートの Streamable HTTP サーバーに対応した MCP クライアントを使用します。

{
  "mcpServers": {
    "atlarium": {
      "type": "streamable-http",
      "url": "https://mcp.atlarium.bio/mcp"
    }
  }
}

Claude Code のリモート HTTP の例:

claude mcp add --transport http atlarium https://mcp.atlarium.bio/mcp

稼働中のエンドポイントを簡易チェックします。

curl --fail --silent --show-error https://mcp.atlarium.bio/health
curl --fail --silent --show-error https://mcp.atlarium.bio/.well-known/mcp/server-card.json
pnpm mcp:monitor:public

クライアントのセットアップ

クライアントまたはホストセットアップ
OpenAI Agents SDKリモートの Streamable HTTP エンドポイントに接続する Python エージェントについては、examples/openai-agents-python を参照してください。
Claude Codeclaude mcp add --transport http atlarium https://mcp.atlarium.bio/mcp を実行し、Claude に Atlarium を使用するよう依頼します。
CursorCursor に追加するディープリンク またはルートの mcp.json を使用します。
Clineホストされているエンドポイントを Streamable HTTP のリモートサーバーとして追加します。エージェントのセットアップ手順は llms-install.md に記載されています。
Windsurfexamples/windsurf/mcp_config.json を Windsurf の MCP 設定にコピーし、Cascade の MCP サーバーを更新します。
VS Codeexamples/vscode/mcp.json をコピーします。VS Code ではリモート MCP サーバーに type: "http" を使用します。
Antigravityリモート MCP サーバーに対応したビルドでのみ examples/antigravity/mcp.json を使用します。
汎用 Streamable HTTPexamples/generic-streamable-http の JSON-RPC の例を使用します。
ChatGPT Apps既存のアプリバージョン 1.0.0 は OpenAI ダッシュボードで承認済みです。修正版の 2.0.3 パッケージは、分類体系に依存しないテストとともに 2026-08-29 に再提出され、OpenAI Platform では現在 Review と表示されています。審査に関するメモとスモークテスト用プロンプトについては、examples/chatgpt-apps と docs/chatgpt-review-remediation.md を参照してください。

これらは互換性に関する注記であり、ベンダーの推奨を意味するものではありません。 該当するベンダーが掲載を承認していない限り、ChatGPT、Claude、Cursor、Windsurf、 VS Code、Antigravity、またはいずれかのディレクトリについて、ベンダーや ディレクトリの対応状況を主張しないでください。

ChatGPT アプリとウィジェット

サーバーは、Apps 対応ホスト向けに読み取り専用の MCP Apps/ChatGPT Apps ウィジェットリソースを公開します。

フィールド値
リソース URIui://widget/habitat-explorer.v4.html
MIME タイプtext/html;profile=mcp-app
ウィジェットAtlarium Habitat Explorer
ウィジェットのドメインhttps://mcp.atlarium.bio
出力モードプレーンな JSON テキストと structuredContent

このウィジェットは、公開されている生息環境の検索結果、プロフィール、診断の概要、製品の検索結果、計算結果、相性の概要、施肥プラン、生息環境の提案を表示します。書き込みアクセスを追加することはなく、ワークスペース、認証、管理者、ジャーナル、スケジュール、測定データも公開しません。

ウィジェット専用の開発スクリーンショットと短いデモ動画は、docs/assets/chatgpt-screenshots/ と docs/assets/chatgpt-app-demo.mp4 にチェックインされています。実際のホスト上でのウェブ表示とレスポンシブ 390x844 のキャプチャは docs/assets/chatgpt-screenshots/real-host/ に保存されています。最終レビュー用パッケージには、ネイティブの iOS/Android 録画が引き続き必要です。v4/2.0.3 候補版は MCP エンドポイントで公開されていますが、新しい ChatGPT アプリのバージョンとしてはまだ承認されていません。OpenAI が承認するまでは、そのアプリの申請が承認済みであると説明しないでください。既存のダッシュボードアプリのバージョン 1.0.0 は承認済みです。

ツールの一覧

分野ツール
魚と水生動物search_fish, get_fish_profile
水生植物search_plants, get_plant_profile
製品とガイドsearch_products, get_product_profile, search_guides, get_guide
診断search_algae, get_algae_profile, search_diseases, get_disease_profile, search_plant_problems, get_plant_problem_profile, search_medicines, get_medicine_profile, match_diagnostic_profiles
製品カタログlist_product_categories, list_product_brands, search_equipment, get_equipment_profile, search_fertilizers, get_fertilizer_profile
相性と水質check_species_compatibility, get_water_parameters, suggest_species_for_tank
施肥search_fertilization_regimes, get_fertilization_regime, calculate_fertilizer_dose, calculate_nutrient_gaps, calculate_weekly_dose_totals, generate_fertilization_plan
計算ツールcalculate_tank_volume, calculate_tank_weight, calculate_water_change, calculate_water_chemistry, convert_units, calculate_equipment_requirements
生息環境プランナーsuggest_habitat_for_tank

すべてのツールには、読み取り専用の注釈が登録されています。 readOnlyHint: true、openWorldHint: false、destructiveHint: false、 idempotentHint: true。

ガイド付きプロンプト

サーバーは、種の検索、相性、生息環境の計画、藻類、病気、植物の問題、製品の選定、施肥、タンクの計算に関するガイド付きプロンプトを公開します。プロンプトは、クライアントを同じ公開読み取り専用ツールの一覧へ誘導します。新たな機能や書き込みアクセスを追加するものではありません。

ツール呼び出しの例

各例には、MCP ツール名と最小限の有効な JSON 入力が示されています。一般的な MCP クライアントはプレーンな JSON テキストを受け取り、Apps 対応ホストでは structuredContent も使用できます。

カタログ、植物、ガイド
search_fish

目的:魚や水生動物のプロフィールを検索します。

プロンプト:「90 L の水草水槽に適した、初心者向けの小型魚を探してください。」

{
  "query": "tetra",
  "language": "en",
  "min_tank_liters": 40,
  "max_tank_liters": 120,
  "limit": 5
}

出力:一致した公開動物プロフィール。スラッグ、ローカライズされた名前、概要フィールド、利用可能な場合は公開 URL が含まれます。

get_fish_profile

目的:魚または水生動物の構造化プロフィールを 1 件取得します。

プロンプト:「ネオンテトラの Atlarium プロフィールを表示してください。」

{
  "slug": "paracheirodon-innesi",
  "language": "en"
}

出力:公開プロフィールデータ、飼育パラメーター、分類、関連情報、利用可能な場合はローカライズされたコンテンツが含まれます。

search_plants

目的:水生植物のプロフィールを検索します。

プロンプト:「ローテク水槽向けの、育てやすい前景草または中景草を探してください。」

{
  "query": "anubias",
  "language": "en",
  "difficulty": "easy",
  "limit": 5
}

出力:一致した公開植物プロフィール。植栽位置、難易度、利用可能な場合は公開 URL が含まれます。

get_plant_profile

目的:水草の構造化されたプロフィールを1件取得します。

プロンプト:「Anubias barteri のプロフィールを開いてください。」

{
  "slug": "anubias-barteri",
  "language": "en"
}

出力:利用可能な場合、水草の要件、生育情報、構造化された属性、ローカライズされたコンテンツを返します。

search_products

目的:公開されている生息環境向け製品を検索します。

プロンプト:「淡水水槽用のフィルター製品を探してください。」

{
  "query": "filter",
  "language": "en",
  "category": "filter",
  "limit": 5
}

出力:利用可能な場合、ブランド/カテゴリ情報と公開製品 URL を含む製品検索結果を返します。

get_product_profile

目的:公開されている製品プロフィールを取得します。

プロンプト:「このカタログスラッグの製品プロフィールを表示してください。」

{
  "slug": "seachem/prime",
  "language": "en"
}

出力:利用可能な場合、構造化された公開製品データ、用途、ブランドの詳細、リンクを返します。

search_guides

目的:Atlarium のガイドと教育コンテンツを検索します。

プロンプト:「水槽の立ち上げに関する公開ガイドを探してください。」

{
  "query": "cycling",
  "language": "en",
  "topic": "aquarium",
  "limit": 5
}

出力:利用可能な場合、タイトル、概要、トピック、公開 URL を含むガイドの検索結果を返します。

get_guide

目的:公開されている Atlarium のガイドを1件取得します。

プロンプト:「窒素サイクルのガイドを開いてください。」

{
  "slug": "aquarium/nitrogen-cycle",
  "language": "en"
}

出力:構造化された公開ガイドのコンテンツと関連メタデータを返します。

診断と治療に関するリファレンス
search_algae

目的:藻類の診断プロフィールを検索します。

プロンプト:「水槽のガラスに付着するグリーンダストに関する藻類プロフィールを探してください。」

{
  "query": "green dust",
  "language": "en",
  "difficulty": 2,
  "limit": 5
}

出力:症状、考えられる原因、助言となるガイダンスを含む藻類の検索結果を返します。

get_algae_profile

目的:藻類のプロフィールを1件取得します。

プロンプト:「緑斑藻のプロフィールを表示してください。」

{
  "slug": "green-spot-algae",
  "language": "en"
}

出力:症状、原因、予防、助言となる対応を含む、構造化された公開藻類プロフィールを返します。

search_diseases

目的:水生生物の病気プロフィールを検索します。

プロンプト:「魚の白い斑点に関する病気プロフィールを探してください。」

{
  "query": "white spots",
  "language": "en",
  "water_type": "freshwater",
  "limit": 5
}

出力:考えられる病気プロフィールと、助言となる治療リファレンスを返します。

get_disease_profile

目的:病気プロフィールを1件取得します。

プロンプト:「白点病のプロフィールを開いてください。」

{
  "slug": "ich",
  "language": "en"
}

出力:症状、考えられる原因、治療リファレンス、免責事項を返します。

search_plant_problems

目的:水草の欠乏症、害虫、環境に関するプロフィールを検索します。

プロンプト:「水槽の水草の葉が黄変する原因を探してください。」

{
  "query": "yellow leaves",
  "language": "en",
  "type": "deficiency",
  "limit": 5
}

出力:症状、原因、助言となる是正策を含む水草の問題の検索結果を返します。

get_plant_problem_profile

目的:水草の問題プロフィールを1件取得します。

プロンプト:「窒素欠乏症のプロフィールを開いてください。」

{
  "slug": "nitrogen-deficiency",
  "language": "en"
}

出力:構造化された欠乏症/問題データと、助言となるガイダンスを返します。

search_medicines

目的:水槽用の薬と治療製品のプロフィールを検索します。

プロンプト:「白点病の治療に関する公開薬剤リファレンスを探してください。」

{
  "query": "ich",
  "language": "en",
  "limit": 5
}

出力:利用可能な場合、公開プロフィールデータを含む薬剤/治療リファレンスを返します。

get_medicine_profile

目的:薬剤プロフィールを1件取得します。

プロンプト:「薬剤スラッグのプロフィールを開いてください。」

{
  "slug": "malachite-green",
  "language": "en"
}

出力:構造化された公開薬剤リファレンス、使用上の注意、免責事項を返します。

match_diagnostic_profiles

目的:症状のテキストを、藻類、病気、水草の問題、薬剤のプロフィールと照合します。

プロンプト:「流木に生えたふわふわした白いものと、魚のストレス症状を照合してください。」

{
  "query": "white fuzzy growth and fish flashing",
  "language": "en",
  "limit": 8
}

出力:関連度順に分類された、可能性の高い公開診断プロフィールを返します。

製品、機器、肥料
list_product_categories

目的:機器と肥料の製品カテゴリを一覧表示します。

プロンプト:「公開されている機器カテゴリには何がありますか?」

{
  "language": "en",
  "type": "equipment"
}

出力:ローカライズされた公開カテゴリ名と識別子を返します。

list_product_brands

目的:公開製品のブランドを一覧表示します。

プロンプト:「Seachem に一致するブランドを一覧表示してください。」

{
  "language": "en",
  "query": "Seachem"
}

出力:一致する公開ブランド名とメタデータを返します。

search_equipment

目的:水槽および生息環境向けの機器製品を検索します。

プロンプト:「淡水環境向けのヒーターを探してください。」

{
  "query": "heater",
  "language": "en",
  "use_case": "freshwater",
  "limit": 5
}

出力:構造化された公開カタログ項目を含む機器製品の検索結果を返します。

get_equipment_profile

目的:1つの機器製品のプロフィールを取得します。

プロンプト:「この機器のプロフィールを開いてください。」

{
  "slug": "eheim/thermocontrol",
  "language": "en"
}

出力:公開されている機器の詳細、カテゴリ、ブランド、用途に関する項目(利用可能な場合)。

search_fertilizers

目的:肥料製品と栄養素プロフィールを検索します。

プロンプト:「水草水槽用の液体肥料を探してください。」

{
  "query": "flourish",
  "language": "en",
  "category": "fertilizer",
  "limit": 5
}

出力:肥料製品の検索結果と栄養素のメタデータ(利用可能な場合)。

get_fertilizer_profile

目的:1つの肥料プロフィールを取得します。

プロンプト:「この肥料のプロフィールを開いてください。」

{
  "slug": "seachem/flourish",
  "language": "en"
}

出力:構造化された肥料データ、施肥量のメタデータ、公開カタログの詳細(利用可能な場合)。

相性、水質、生息環境の提案
check_species_compatibility

目的:生息環境における種同士の基本的な相性を確認します。

プロンプト:「90 Lの水草水槽で、ネオンテトラとコリドラス・パレアタスは一緒に飼えますか?」

{
  "species": ["Paracheirodon innesi", "Corydoras paleatus"],
  "language": "en",
  "tank_liters": 90,
  "ph": 6.8,
  "temperature": 24
}

出力:相性に関する参考情報、警告、根拠、制約。

get_water_parameters

目的:魚または植物に推奨される水質パラメータを取得します。

プロンプト:「ネオンテトラが好む水質パラメータを教えてください。」

{
  "slug": "paracheirodon-innesi",
  "type": "fish",
  "language": "en"
}

出力:公開されている水温、pH、GH/KH、関連する水質パラメータの指針(利用可能な場合)。

suggest_species_for_tank

目的:水槽と水質パラメータに基づいて水生生物を提案します。

プロンプト:「120 Lの水草水槽に適した、初心者向けの生物を提案してください。」

{
  "tank_liters": 120,
  "language": "en",
  "ph": 6.8,
  "temperature": 24,
  "beginner_friendly": true,
  "planted_tank": true,
  "limit": 8
}

出力:警告と基本的な根拠を添えた、公開されている生物の提案。

suggest_habitat_for_tank

目的:公開されている総合的な生息環境プランを提案します。

プロンプト:「120 L向けに、バランスの取れた水草コミュニティ水槽の生息環境を計画してください。」

{
  "tank_liters": 120,
  "language": "en",
  "ph": 6.8,
  "temperature": 24,
  "beginner_friendly": true,
  "planted_tank": true,
  "co2": "low",
  "light_level": "medium",
  "setup_intent": "community",
  "target_difficulty": "balanced",
  "water_type": "FRESHWATER",
  "limit": 8
}

出力:魚、無脊椎動物、水草、製品、警告、提案理由、関連ガイド、参考情報である旨の免責事項。

施肥
search_fertilization_regimes

目的:施肥レジメンと施肥の考え方を検索します。

プロンプト:「低技術水草水槽向けの施肥レジメンを探してください。」

{
  "query": "low tech",
  "language": "en",
  "topic": "planted",
  "limit": 5
}

出力:概要、トピック、公開URLを含む、公開されているレジメンの検索結果(利用可能な場合)。

get_fertilization_regime

目的:1つの施肥レジメンを取得します。

プロンプト:「Estimative Indexレジメンのプロフィールを開いてください。」

{
  "slug": "estimative-index",
  "language": "en"
}

出力:公開されている施肥の考え方/レジメンの詳細を構造化して表示します。

calculate_fertilizer_dose

目的:カタログ掲載製品と水槽の容量に基づき、参考用の肥料量を計算します。

プロンプト:「120 L用のSeachem Flourishの量を計算してください。」

{
  "brand_name": "Seachem",
  "product_name": "Flourish",
  "volume_liters": 120
}

出力:参考用の施肥量の推定値と、製品に関連する施肥量の情報。

calculate_nutrient_gaps

目的:栄養素の測定値を目標値と比較します。

プロンプト:「硝酸塩とカリウムの測定値を、水草水槽の目標値と比較してください。」

{
  "language": "en",
  "volume_liters": 120,
  "measurements": [
    {
      "kind": "nitrogen_mg_l",
      "value": 5
    },
    {
      "kind": "potassium_mg_l",
      "value": 8
    }
  ],
  "targets": {
    "nitrogen_mg_l": 10,
    "potassium_mg_l": 15
  }
}

出力:測定値を保存せずに、栄養素の不足量を推定します。

calculate_weekly_dose_totals

目的:保存されない施肥プランの週間合計量を計算します。

プロンプト:「液体肥料の週間使用プランを合計してください。」

{
  "language": "en",
  "volume_liters": 120,
  "items": [
    {
      "brand_name": "Seachem",
      "product_name": "Flourish",
      "method": "LIQUID",
      "dose_value": 5,
      "dose_unit": "ml",
      "days_of_week": [1, 3, 5]
    }
  ]
}

出力:製品ごとの週間合計量とスケジュールの概要。

generate_fertilization_plan

目的:参考用の、保存されない施肥プランを生成します。

プロンプト:「120 Lの水草水槽向けに、バランスの取れた施肥プランを作成してください。」

{
  "language": "en",
  "volume_liters": 120,
  "regime": "balanced",
  "targets": {
    "nitrogen_mg_l": 10,
    "phosphorus_mg_l": 1,
    "potassium_mg_l": 15,
    "iron_mg_l": 0.1
  }
}

出力:参考用プラン、栄養素の目標値、製品の提案、免責事項。

計算ツール
calculate_tank_volume

目的:水槽の総容量と正味容量の推定値を計算します。

プロンプト:「60 x 30 x 36 cmの水槽の正味容量を計算してください。」

{
  "shape": "rect",
  "length_cm": 60,
  "width_cm": 30,
  "height_cm": 36,
  "substrate_depth_cm": 5,
  "hardscape_displacement_liters": 4
}

出力:総容量と正味容量の推定値。

calculate_tank_weight

目的:寸法と素材の入力値に基づき、水槽の重量を推定します。

プロンプト:「120 L水槽に水を入れたときの重量を推定してください。」

{
  "shape": "rect",
  "length_cm": 80,
  "width_cm": 35,
  "height_cm": 45,
  "glass_thickness_mm": 8,
  "substrate_depth_cm": 6,
  "hardscape_weight_kg": 12,
  "equipment_weight_kg": 5
}

出力:参考用の総重量の推定値と構成要素の内訳。

calculate_water_change

目的:水換え量、週間合計量、希釈の推定値を計算します。

プロンプト:「120 Lの水槽で週2回、30パーセントの水換えをすると、どれくらいの水量になりますか?」

{
  "volume_liters": 120,
  "change_percent": 30,
  "changes_per_week": 2
}

出力:1回あたりの水換え量と週間合計量の推定値。

calculate_water_chemistry

目的:硬度の換算、CO2、塩分濃度、水の混合を計算します。

プロンプト:「pH 6.8、KH 4からCO2濃度を推定してください。」

{
  "co2": {
    "ph": 6.8,
    "kh_dkh": 4
  },
  "general_hardness": {
    "unit": "dgh",
    "value": 8
  }
}

出力:一般公開されている水質化学の換算値と参考用の推定値。

convert_units

目的:水槽に関連する単位を換算します。

プロンプト:「120リットルと24 Cを換算してください。」

{
  "volume": {
    "unit": "l",
    "value": 120
  },
  "temperature": {
    "unit": "c",
    "value": 24
  }
}

出力:対応単位への換算値。

calculate_equipment_requirements

目的:ヒーター、照明、電力の要件を参考用に計算します。

プロンプト:「120 Lの水槽に必要なヒーターと照明を推定してください。」

{
  "heater": {
    "volume_liters": 120,
    "ambient_c": 20,
    "target_c": 25,
    "insulation": "normal"
  },
  "lighting": {
    "volume_liters": 120,
    "lumens": 3600
  },
  "electricity": {
    "wattage": 100,
    "hours_per_day": 8,
    "cost_per_kwh": 0.25
  }
}

出力:機器の参考用推定値と、電力使用量/コストの概要。

ディレクトリへの掲載状況

ディレクトリステータス
Official MCP Registrybio.atlarium/habitat-database として公開済みです。リリース 2.0.3 が有効な最新版です。
GitHub正式な公開ソースリポジトリです。
Glama所有権確認済みです。39個のツールと正式なV2の説明を掲載し、正常な状態です。
Smithery公開済みの掲載情報です。本番環境ではバージョン 2.0.3、39個のツール、9個のプロンプトを公開しています。ディレクトリの更新は保留中です。
MCP.so公開掲載済みです。2.0.2 の更新はディレクトリ側の処理待ちです。
PulseMCP公開掲載済みです。バッジを追加する前に、バッジのポリシーを確認してください。
mcpservers.orgtechgardeners/atlarium-mcp で公開掲載済みです。バッジはまだ追加されていません。
MCPRepository公開済みの掲載情報です。公開ページで確認済みです。
MCP Market正式なリポジトリと読み取り専用のツールメタデータを掲載し、公開掲載済みです。
MCP Scoreboard公開掲載されていますが、スコアはまだ付いていません。スコアバッジは掲載していません。
MCP Queenライブのプロトコルプローブを備えた確認済みの公開情報ページです。

公開状況の追跡情報と再利用可能な申請文面は、 config/distribution-registry.json、docs/publication-checklist.md、 docs/directory-submission-payloads.md、docs/mcp-submission-cockpit.md にあります。 保留中、ブロック中、却下された掲載先は運用レジストリに残し、 公開掲載が承認済みであるかのようには表示しません。

ローカル開発

pnpm install
cp .env.example .env
pnpm dev

デフォルトでは、サーバーは http://localhost:43118 でリッスンします。

Atlariumアプリに対するローカル開発:

ATLARIUM_API_BASE_URL=http://localhost:43117/api/public/mcp/v1 pnpm dev

設定

  • MCP_PUBLIC_BASE_URL:公開ベースURL。本番環境のデフォルトは https://mcp.atlarium.bio です。
  • ATLARIUM_API_BASE_URL:公開読み取り専用のAtlarium APIベースURLです。
  • MCP_ALLOWED_HOSTS:DNSリバインディング対策に使用する、カンマ区切りのホスト許可リストです。
  • MCP_TRUST_PROXY:Expressのプロキシ信頼設定です。デフォルトの 1 は、本番環境で信頼できるリバースプロキシが1つあることを前提とします。
  • ATLARIUM_API_TIMEOUT_MS:上流の公開APIのタイムアウト(ミリ秒)です(デフォルト:15000)。
  • MCP_PUBLIC_PROBE_ATTEMPTS:読み取り専用の公開モニターの試行回数です(デフォルト:3)。
  • MCP_PUBLIC_PROBE_RETRY_DELAY_MS:公開モニターの初回再試行待機時間です。失敗するたびに2倍になります(デフォルト:1000)。
  • ATLARIUM_API_RESPONSE_MAX_BYTES:上流からのJSONレスポンスの最大サイズです。
  • OPENAI_APPS_CHALLENGE_TOKEN:/.well-known/openai-apps-challenge から提供される、公開OpenAI Appsドメイン検証トークンです。

本番環境へのデプロイでは、TLSを終端するリバースプロキシまたはIngressの背後でサーバーを実行し、 このサーバーにトラフィックが到達する前に X-Forwarded-For、X-Forwarded-Host、 X-Forwarded-Proto を上書きする必要があります。

品質ゲート

pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm audit:prod
docker build -t atlarium-mcp:local .

ローカルサーバーの実行中:

pnpm mcp:conformance

本番環境のDNSとTLSが有効な状態:

pnpm mcp:monitor:public
pnpm directories:submit -- --check
pnpm mcp:validate:public
pnpm mcp:conformance:public

貢献

CONTRIBUTING.md を参照してください。公開ツールを変更する場合は、同じリリースでサーバーの実装、テスト、サーバーカードのメタデータ、server.json、README.md、docs/mcp.md、ドキュメント、サンプル、ディレクトリへの公開に関する注記を更新する必要があります。

セキュリティ

SECURITY.md を参照してください。機密性の高いセキュリティ上の問題を、公開 GitHub イシューで報告しないでください。

ライセンス

MIT。LICENSE を参照してください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。