RSpace MCP Server

Instructions

Implementation Reference

• main.py:131-146 (handler)

  Handler function that retrieves a single RSpace ELN document by ID (numeric or global ID), fetches its full content using eln_cli, concatenates all field contents into a single 'content' string, and returns it as a FullDocument model instance.

  @mcp.tool(tags={"rspace"}, name="get_single_Rspace_document")
  def get_document(doc_id: int | str) -> FullDocument:
      """
      Retrieves complete content of a single document
      
      Usage: Get full document text for reading/analysis
      Parameters: doc_id can be numeric ID or string globalId (e.g., "SD12345")
      Returns: Full document with concatenated field content
      """
      resp = eln_cli.get_document(doc_id)
      # Concatenate all field content for easier processing
      resp['content'] = ''
      for fld in resp['fields']:
          resp['content'] = resp['content'] + fld['content']
      return resp

• main.py:47-50 (schema)

  Pydantic model used as the return type for the get_single_Rspace_document tool, defining a document with a single concatenated 'content' field containing all text from the document's fields.

  class FullDocument(BaseModel):
      """Complete ELN document with all content concatenated"""
      content: str = Field(description="concatenated text content from all fields")

• main.py:131-131 (registration)

  FastMCP decorator that registers the get_document function as the tool named 'get_single_Rspace_document' with 'rspace' tag.

  @mcp.tool(tags={"rspace"}, name="get_single_Rspace_document")