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] = []