Atlarium Habitat Database MCP について
Atlarium Habitat Database MCPは、水槽などの飼育環境データを扱うAIエージェントやクライアント向けの公開読み取り専用サーバーです。生物・製品情報、診断、計算、計画ツールに加え、ガイド付きプロンプトとApps対応ウィジェットを備えています。
主な機能
- 01生物、植物、製品、ガイドの検索
- 02公開プロフィールの構造化データ取得
- 03生物の相性と水質条件の確認
- 04診断と治療情報の検索
- 05水槽、水量、肥料の数値計算
- 06プロンプトとウィジェットによる環境計画
活用シーン
- 01水槽に適した生物や植物の調査
- 02水槽条件に基づく相性確認
- 03藻類、病気、植物の問題候補を調査
- 04水槽の必要条件の推定や飼育環境の計画
MCP 対応
Streamable HTTP経由で、認証不要の公開読み取り専用ツール39種とガイド付きプロンプト9種を提供します。Apps対応ホスト向けに読み取り専用のHabitat Explorerウィジェットも公開します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.atlarium.bio/mcpclaude mcp add --transport http atlarium https://mcp.atlarium.bio/mcp{"mcpServers":{"atlarium":{"type":"http","url":"https://mcp.atlarium.bio/mcp"}}}Cursor で開く{"servers":{"atlarium":{"type":"http","url":"https://mcp.atlarium.bio/mcp"}}}VS Code で開く{"mcpServers":{"atlarium":{"type":"http","url":"https://mcp.atlarium.bio/mcp"}}}{"mcpServers":{"atlarium":{"serverUrl":"https://mcp.atlarium.bio/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
39| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| query | string | いいえ | 公開 Atlarium レコードとの照合に使用する検索テキスト。 |
| language | enum | いいえ | 任意の優先応答言語:it、en、es。it | en | es |
| min_tank_liters | number | いいえ | リットル単位の水槽容量の最小値フィルター。 |
| max_tank_liters | number | いいえ | リットル単位の水槽容量の最大値フィルター。 |
| ph_min | number | いいえ | 許容される pH の最小値フィルター。 |
| ph_max | number | いいえ | 許容される pH の最大値フィルター。 |
| gh_min | number | いいえ | 総硬度の最小値フィルター。 |
| gh_max | number | いいえ | 総硬度の最大値フィルター。 |
| kh_min | number | いいえ | 炭酸塩硬度の最小値フィルター。 |
| kh_max | number | いいえ | 炭酸塩硬度の最大値フィルター。 |
| temperature_min | number | いいえ | 摂氏で指定する温度の最小値フィルター。 |
| temperature_max | number | いいえ | 摂氏で指定する温度の最大値フィルター。 |
| temperament | string | いいえ | 性質のフィルター。例:温和、攻撃的。 |
| care_level | string | いいえ | 飼育難易度のフィルター。例:初心者向け、中級者向け、上級者向け。 |
| limit | integer | いいえ | 返す公開レコードの最大数。上限は 50 件です。 |
| offset | integer | いいえ | 公開検索結果の 0 始まりのページネーションオフセット。 |
詳細
Atlarium Habitat Database MCP
Atlarium の生息環境データ、診断、製品、計算ツール、アドバイザリープランニングを提供する、一般公開の読み取り専用 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 Code | claude mcp add --transport http atlarium https://mcp.atlarium.bio/mcp を実行し、Claude に Atlarium を使用するよう依頼します。 |
| Cursor | Cursor に追加するディープリンク またはルートの mcp.json を使用します。 |
| Cline | ホストされているエンドポイントを Streamable HTTP のリモートサーバーとして追加します。エージェントのセットアップ手順は llms-install.md に記載されています。 |
| Windsurf | examples/windsurf/mcp_config.json を Windsurf の MCP 設定にコピーし、Cascade の MCP サーバーを更新します。 |
| VS Code | examples/vscode/mcp.json をコピーします。VS Code ではリモート MCP サーバーに type: "http" を使用します。 |
| Antigravity | リモート MCP サーバーに対応したビルドでのみ examples/antigravity/mcp.json を使用します。 |
| 汎用 Streamable HTTP | examples/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 ウィジェットリソースを公開します。
| フィールド | 値 |
|---|---|
| リソース URI | ui://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 Registry | bio.atlarium/habitat-database として公開済みです。リリース 2.0.3 が有効な最新版です。 |
| GitHub | 正式な公開ソースリポジトリです。 |
| Glama | 所有権確認済みです。39個のツールと正式なV2の説明を掲載し、正常な状態です。 |
| Smithery | 公開済みの掲載情報です。本番環境ではバージョン 2.0.3、39個のツール、9個のプロンプトを公開しています。ディレクトリの更新は保留中です。 |
| MCP.so | 公開掲載済みです。2.0.2 の更新はディレクトリ側の処理待ちです。 |
| PulseMCP | 公開掲載済みです。バッジを追加する前に、バッジのポリシーを確認してください。 |
| mcpservers.org | techgardeners/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 を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。