Sonoma Animal Services

@pipeworx/sonoma-animal-services

Sonoma County Animal Services（カリフォルニア州サンタローザ／ソノマ郡）のシェルター受け入れ・処置記録をリアルタイムで取得します。最近の受け入れ、動物の検索（「この動物はまだシェルターにいるか」も含む）、処置の概要を確認できます。

Pipeworx の一部です。AI エージェントを1683以上のリアルタイムデータソースに接続するMCPゲートウェイです。

ツール

• sonoma_recent_intakes(days?, animal_type?, intake_type?, limit?) — 最近の受け入れ（デフォルトでは過去30日間）と、期間内の合計件数を取得します。
• sonoma_search_animal(animal_id?, name?, breed?, in_shelter_only?, limit?) — ID、名前、または品種で動物を検索します。in_shelter_only=true は 「現在シェルターに[品種]はいますか」という質問に答えます。outcome_date がまだ 設定されていない動物は、引き続きシェルターにいます。
• sonoma_outcomes_summary(since?, group_by?) — outcome_type、 animal_type、または month ごとに分類した処置件数を取得します。

認証

キーは不要です。より高いレート制限を利用するには、独自のSocrataアプリトークンを_apiKeyで渡してください。

データソース

• https://data.sonomacounty.ca.gov/resource/924a-vesw.json — 「Animal Shelter Intake and Outcome」。1匹の動物につき1行で、受け入れと処置の両方のフィールドが同じレコードに含まれます（受け入れと処置を別々のデータセットに分けているAustinとは異なります）。outcome_date IS NULL は、その動物がまだシェルターを出ていないことを意味します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "sonoma-animal-services": {
      "url": "https://gateway.pipeworx.io/sonoma-animal-services/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/sonoma-animal-services/mcp の tools/list は、上の表にあるツールに加えて、共通の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとあわせて、およそ30個の共通ツールが表示されます。接続のinitialize応答には正確な対象範囲が示されており、その日付時点での正式な回答となります。

これは意図的な仕様であり、偶然に多重化されているわけではありません。パックの対象範囲外の質問にも、カタログ全体を検索するask_pipeworxを通じて回答できるようにするのが、メタツールの役割です。MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキストのコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx ゲートウェイ全体に接続してください。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと1683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworxを使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTPで呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/sonoma_recent_intakes \
  -H 'Content-Type: application/json' \
  -d '{"days":30}'

最初の呼び出しではアカウントは不要です。ツールの内容を確認するには、GET https://gateway.pipeworx.io/v1/tools/sonoma_recent_intakesを呼び出します。ツールを探すには、POST https://gateway.pipeworx.io/v1/tools/search_packsに{"query":"..."}を指定します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルのstdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイを経由する必要もありません。

{
  "mcpServers": {
    "sonoma-animal-services": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-sonoma-animal-services"]
    }
  }
}

または、起動することを確認するために直接実行します。

npx -y @pipeworx/mcp-sonoma-animal-services

stdin／stdout経由でMCPを扱い、このパック独自のツールだけを対象にinitialize／tools/list／tools/callへ応答します。上記のゲートウェイ接続で追加される共通メタツールはありません。同じデータソース、同じツールを利用できますが、ask_pipeworxによるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントとゲートウェイ全体のどちらでも利用できます。

ask_pipeworx({ question: "your question about Sonoma Animal Services data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT