Yaizu Smart City MCP Server

Instructions

Implementation Reference

• mcp/server.py:313-423 (handler)

  The core handler function for the 'get_api_details' MCP tool. It is decorated with @mcp.tool() for automatic registration and schema inference from the function signature. Retrieves and formats detailed information about a specific API using the doc_manager.

  @mcp.tool()
  async def get_api_details(api_name: str) -> str:
      """
      特定のAPIの詳細情報を取得します。
      
      Args:
          api_name: API名またはファイル名（拡張子なし）
      
      Returns:
          str: API詳細情報
      """
      try:
          # まずファイル名として検索
          doc = doc_manager.load_api_docs(api_name)
          
          if not doc:
              # API名で検索
              results = doc_manager.search_apis(api_name)
              if results:
                  api = results[0]['api']
                  doc = api
              else:
                  return f"「{api_name}」というAPIが見つかりませんでした。"
          
          # 詳細情報の整形
          output = f"# API詳細情報\n\n"
          
          if isinstance(doc, dict):
              # データモデル形式の場合
              if 'dataModelName' in doc:
                  output += f"## {doc['dataModelName']}\n\n"
                  output += f"**FIWAREサービス**: {doc.get('fiwareService', '')}\n"
                  output += f"**サービスパス**: {doc.get('fiwareServicePath', '')}\n"
                  output += f"**エンティティタイプ**: {doc.get('entityType', '')}\n"
                  output += f"**エンティティIDパターン**: {doc.get('entityIdPattern', '')}\n\n"
                  
                  # 属性情報
                  if 'attributes' in doc:
                      output += f"### 属性 ({len(doc['attributes'])}個)\n"
                      for attr_key, attr_info in doc['attributes'].items():
                          output += f"- **{attr_key}** ({attr_info.get('name', '')}): {attr_info.get('description', '')} - {attr_info.get('type', '')}\n"
                      output += "\n"
                  
                  # リクエスト例
                  if 'example_request' in doc:
                      output += "### リクエスト例\n```json\n"
                      output += json.dumps(doc['example_request'], ensure_ascii=False, indent=2)
                      output += "\n```\n\n"
                  
                  # レスポンス例
                  if 'example_response' in doc:
                      output += "### レスポンス例\n```json\n"
                      output += json.dumps(doc['example_response'], ensure_ascii=False, indent=2)[:2000]
                      output += "\n```\n\n"
                  
                  return output
              
              # 従来形式の場合
              # タイトル
              if 'title' in doc:
                  output += f"## {doc['title']}\n\n"
              elif 'name' in doc:
                  output += f"## {doc['name']}\n\n"
              
              # 基本情報
              if 'description' in doc:
                  output += f"**説明**: {doc['description']}\n\n"
              
              if 'category' in doc:
                  output += f"**カテゴリ**: {doc['category']}\n\n"
              
              # エンドポイント
              if 'endpoints' in doc and doc['endpoints']:
                  output += "### エンドポイント\n"
                  for endpoint in doc['endpoints']:
                      output += f"- `{endpoint}`\n"
                  output += "\n"
              
              # データモデル
              if 'data_models' in doc and doc['data_models']:
                  output += "### データモデル\n```json\n"
                  output += json.dumps(doc['data_models'], ensure_ascii=False, indent=2)
                  output += "\n```\n\n"
              
              # パラメータ
              if 'parameters' in doc and doc['parameters']:
                  output += "### パラメータ\n"
                  for param in doc['parameters']:
                      if isinstance(param, dict):
                          output += f"- **{param.get('name', 'unknown')}**: {param.get('description', '')}\n"
                  output += "\n"
              
              # APIs配列がある場合
              if 'apis' in doc:
                  output += f"### 含まれるAPI ({len(doc['apis'])}個)\n"
                  for api in doc['apis'][:10]:  # 最大10個まで表示
                      output += f"- {api.get('name', '名称不明')}: {api.get('description', '')[:50]}...\n"
                  output += "\n"
              
              # メタデータ
              if 'metadata' in doc:
                  output += "### メタデータ\n"
                  output += f"- **取得日時**: {doc['metadata'].get('scraped_at', '不明')}\n"
                  output += f"- **ソースURL**: {doc['metadata'].get('source_url', '不明')}\n"
                  output += f"- **バージョン**: {doc['metadata'].get('version', '不明')}\n"
          
          return output
          
      except Exception as e:
          logger.error(f"詳細取得エラー: {e}")
          return f"❌ API詳細の取得中にエラーが発生しました: {str(e)}"