MCP-DBLP

Instructions

Implementation Reference

• src/mcp_dblp/server.py:457-487 (handler)

  Handler for the 'export_bibtex' tool: validates input, calls helper to export BibTeX entries to file, clears the session buffer, and returns success message.

  case "export_bibtex":
      if not bibtex_buffer:
          return [
              types.TextContent(
                  type="text",
                  text="Error: Collection is empty. Add entries using add_bibtex_entry first.",
              )
          ]
  
      path = arguments.get("path")
      if not path:
          return [
              types.TextContent(
                  type="text",
                  text="Error: Missing required parameter 'path'",
              )
          ]
  
      # Convert dict values to list for writing
      entries = list(bibtex_buffer.values())
      filepath = export_bibtex_entries(entries, path)
  
      count = len(bibtex_buffer)
      bibtex_buffer.clear()  # Clear after export
  
      return [
          types.TextContent(
              type="text", text=f"Exported {count} references to {filepath}"
          )
      ]
  case _:

• src/mcp_dblp/server.py:237-257 (schema)

  Tool schema definition for 'export_bibtex', including name registration, description, and input schema requiring 'path' parameter.

  types.Tool(
      name="export_bibtex",
      description=(
          "Export all collected BibTeX entries to a .bib file. Call this after adding all entries with add_bibtex_entry.\n"
          "Workflow:\n"
          "  1. Saves all collected entries to a .bib file at the specified path\n"
          "  2. Clears the collection for next export\n"
          "  3. Returns the full path to the exported file\n"
          "Returns error if no entries have been added yet."
      ),
      inputSchema={
          "type": "object",
          "properties": {
              "path": {
                  "type": "string",
                  "description": "Absolute path for the .bib file (e.g., '/path/to/refs.bib'). The .bib extension is added automatically if missing. Parent directories are created if needed.",
              },
          },
          "required": ["path"],
      },
  ),

• src/mcp_dblp/server.py:55-70 (helper)

  Helper function that writes the list of BibTeX entries to the specified file path, auto-adding .bib extension and creating directories.

  def export_bibtex_entries(entries, path):
      """Export BibTeX entries to a file at the specified path."""
      # Ensure .bib extension
      if not path.endswith(".bib"):
          path = f"{path}.bib"
  
      # Create parent directories if needed
      parent_dir = os.path.dirname(path)
      if parent_dir:
          os.makedirs(parent_dir, exist_ok=True)
  
      with open(path, "w", encoding="utf-8") as f:
          for entry in entries:
              f.write(entry + "\n\n")
  
      return path