zotero-mcp

Instructions

Implementation Reference

• src/zotero_mcp/server.py:68-74 (handler)

  Tool registration for "get_item" in the MCP server.

  @mcp.tool(description="Get detailed metadata for a single Zotero item")
  def get_item(item_key: str, format: str = "json") -> str:
      """Get full metadata or BibTeX for one item by its key."""
      result = _get_client().get_item(item_key, fmt=format)
      if isinstance(result, str):
          return result
      return json.dumps(result, ensure_ascii=False)

• src/zotero_mcp/client.py:56-61 (handler)

  Actual implementation of the "get_item" logic using the Zotero client.

  def get_item(self, item_key: str, fmt: str = "json") -> dict | str:
      """Get full metadata for a single item."""
      if fmt == "bibtex":
          return self.zot.item(item_key, format="bibtex")
      item = self.zot.item(item_key)
      return item.get("data", item)