MCP Variance Log

Instructions

Implementation Reference

• src/mcp_variance_log/server.py:356-367 (handler)

  Handler for the 'append_insight' tool. Appends the provided insight to the database's insights list, synthesizes a memo, notifies clients of the update, and returns a success message.
  elif name == "append_insight": if not arguments or "insight" not in arguments: raise ValueError("Missing insight argument") db.insights.append(arguments["insight"]) _ = db._synthesize_memo() # Notify clients that the memo resource has changed await server.request_context.session.send_resource_updated(AnyUrl("memo://insights")) return [types.TextContent(type="text", text="Insight added to memo")]
• src/mcp_variance_log/server.py:231-241 (registration)

  Registration of the 'append_insight' tool in the list_tools handler, including name, description, and input schema.
  types.Tool( name="append_insight", description="Add a business insight to the memo", inputSchema={ "type": "object", "properties": { "insight": {"type": "string", "description": "Business insight discovered from data analysis"}, }, "required": ["insight"], }, ),
• src/mcp_variance_log/db_utils.py:54-72 (helper)

  Helper method in LogDatabase class that generates a formatted business intelligence memo from the list of insights. Called after appending a new insight.
  def _synthesize_memo(self) -> str: """Synthesizes business insights into a formatted memo""" logger.debug(f"Synthesizing memo with {len(self.insights)} insights") if not self.insights: return "No business insights have been discovered yet." insights = "\n".join(f"- {insight}" for insight in self.insights) memo = "📊 Business Intelligence Memo 📊\n\n" memo += "Key Insights Discovered:\n\n" memo += insights if len(self.insights) > 1: memo += "\nSummary:\n" memo += f"Analysis has revealed {len(self.insights)} key business insights that suggest opportunities for strategic optimization and growth." logger.debug("Generated basic memo format") return memo
• src/mcp_variance_log/db_utils.py:20-20 (helper)

  Initialization of the insights list in LogDatabase __init__ method, used to store business insights.
  self.insights: list[str] = []