MCP Server Memos

Instructions

Implementation Reference

• src/mcp_server_memos/server.py:110-122 (handler)

  The primary handler for the 'create_memo' MCP tool. It validates the input arguments using CreateMemoRequest, constructs a protobuf CreateMemoRequest, calls the underlying memo_service gRPC stub to create the memo, and returns a TextContent response with the created memo's name.

  async def create_memo(self, args: dict) -> list[types.TextContent]:
      try:
          params = CreateMemoRequest.model_validate(args)
      except Exception as e:
          raise McpError(types.INVALID_PARAMS, str(e))
  
      req = memos_api_v1.CreateMemoRequest(
          content=params.content,
          visibility=params.visibility.to_proto(),
      )
      res = await self.memo_service.create_memo(create_memo_request=req)
      content = f"Memo created: {res.name}"
      return [types.TextContent(type="text", text=content)]

• src/mcp_server_memos/server.py:40-53 (schema)

  Pydantic BaseModel defining the input schema for the create_memo tool, including content (string) and visibility (enum: PUBLIC, PROTECTED, PRIVATE).

  class CreateMemoRequest(BaseModel):
      """Request to create memo"""
  
      content: Annotated[
          str,
          Field(
              description="""The content of the memo.""",
          ),
      ]
      visibility: Annotated[
          Visibility,
          Field(default=Visibility.PRIVATE, description="""The visibility of the memo."""),
      ]

• src/mcp_server_memos/server.py:166-169 (registration)

  Registration of the 'create_memo' tool in the MCP server's list_tools() handler, specifying name, description, and input schema.

      name=MemosTools.CREATE_MEMO,
      description="Create a new memo",
      inputSchema=CreateMemoRequest.model_json_schema(),
  ),

• src/mcp_server_memos/server.py:187-188 (registration)

  Dispatch logic in the MCP server's call_tool() handler that routes calls to the create_memo handler when the tool name matches.

  elif name == MemosTools.CREATE_MEMO:
      return await tool_adapter.create_memo(args)

• src/mcp_server_memos/server.py:13-18 (helper)

  Enum defining the tool names, including CREATE_MEMO = "create_memo", used throughout for registration and dispatching.

  class MemosTools(str, Enum):
      LIST_MEMO_TAGS = "list_memo_tags"
      SEARCH_MEMO = "search_memo"
      CREATE_MEMO = "create_memo"
      GET_MEMO = "get_memo"