MCP-DBLP

Instructions

Implementation Reference

• src/mcp_dblp/dblp_client.py:498-533 (handler)

  The core handler function that processes a list of publication results to compute statistics including total count, publication time range, top authors by count, and top venues by count.

  def calculate_statistics(results: list[dict[str, Any]]) -> dict[str, Any]:
      """
      Calculate statistics from publication results.
      (Documentation omitted for brevity)
      """
      logger.info(f"Calculating statistics for {len(results)} results")
      authors = Counter()
      venues = Counter()
      years = []
  
      for result in results:
          for author in result.get("authors", []):
              authors[author] += 1
  
          venue = result.get("venue", "")
          # Handle venue as list or string
          if isinstance(venue, list):
              venue = ", ".join(venue) if venue else ""
          if venue:
              venues[venue] += 1
          else:
              venues["(empty)"] += 1
  
          year = result.get("year")
          if year:
              with contextlib.suppress(ValueError, TypeError):
                  years.append(int(year))
  
      stats = {
          "total_publications": len(results),
          "time_range": {"min": min(years) if years else None, "max": max(years) if years else None},
          "top_authors": sorted(authors.items(), key=lambda x: x[1], reverse=True),
          "top_venues": sorted(venues.items(), key=lambda x: x[1], reverse=True),
      }
  
      return stats

• src/mcp_dblp/server.py:196-213 (registration)

  Tool registration in the MCP server's list_tools() method, defining the tool name, description, and input schema for calculate_statistics.

  types.Tool(
      name="calculate_statistics",
      description=(
          "Calculate statistics from a list of publication results.\n"
          "Arguments:\n"
          "  - results (array, required): An array of publication objects, each with at least 'title', 'authors', 'venue', and 'year'.\n"
          "Returns a dictionary with:\n"
          "  - total_publications: Total count.\n"
          "  - time_range: Dictionary with 'min' and 'max' publication years.\n"
          "  - top_authors: List of tuples (author, count) sorted by count.\n"
          "  - top_venues: List of tuples (venue, count) sorted by count (empty venue is treated as '(empty)')."
      ),
      inputSchema={
          "type": "object",
          "properties": {"results": {"type": "array"}},
          "required": ["results"],
      },
  ),

• src/mcp_dblp/server.py:208-212 (schema)

  Input schema definition specifying that the tool requires a 'results' array parameter.

  inputSchema={
      "type": "object",
      "properties": {"results": {"type": "array"}},
      "required": ["results"],
  },

• src/mcp_dblp/server.py:388-400 (registration)

  Dispatch handler in the server's call_tool method that invokes the calculate_statistics function with provided arguments and formats the response.

  case "calculate_statistics":
      if "results" not in arguments:
          return [
              types.TextContent(
                  type="text", text="Error: Missing required parameter 'results'"
              )
          ]
      result = calculate_statistics(results=arguments.get("results"))
      return [
          types.TextContent(
              type="text", text=f"Statistics calculated:\n\n{format_dict(result)}"
          )
      ]

• src/mcp_dblp/server.py:24-24 (registration)

  Import of the calculate_statistics function from dblp_client module.

  calculate_statistics,